Re: Docs: make source file path references consistent

Chao Li <li.evan.chao@gmail.com> writes:
> On Dec 25, 2025, at 17:07, Chao Li <li.evan.chao@gmail.com> wrote:
>> This patch is derived from [1]. While reviewing that thread, I noticed that when the documentation refers to .h and
.cfilesin the PostgreSQL source tree, it uses a mix of full source-tree paths and short relative paths. This
inconsistencycan be confusing for future documentation authors, who may be unsure which form to use. 

> Added to CF for tracking: https://commitfest.postgresql.org/patch/6380/

Is this actually worth spending time on?

Sure, in an ideal world every last line of our source code and
documentation would be totally consistent and read like it had
flowed from a single pen.  But the effort to get there seems
out of proportion to the value, and the effort to keep it there
over time would be even more so.

I'd be much happier to see us spending time on, say, improving
the many barely-intelligible comments in the code.  That takes
serious thought and work though (ChatGPT is unlikely to help).

            regards, tom lane