Re: documentation structure - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: documentation structure
Date
Msg-id CAKFQuwawj_Ow_a_aD7vfi6hYtnv5+BiQYSKN8cV7ZPo8qNF9xQ@mail.gmail.com
Whole thread Raw
In response to Re: documentation structure  (Tatsuo Ishii <ishii@postgresql.org>)
Responses Re: documentation structure
List pgsql-hackers
On Fri, Jul 19, 2024 at 5:47 PM Tatsuo Ishii <ishii@postgresql.org> wrote:
>> IMO the file name should match the ID of the sect1 element with the leading
>> "functions-" removed, naming the directory "functions".  Thus when viewing
>> the web page the corresponding sgml file is determinable.
>
> I'd go for shorter myself (ie "func/"), mainly due to the precedent
> of the existing subdirectory which is "ref/" not "reference/".
> It's hardly a big deal though.

I don't have strong preference neither but I agree that "func/" is
more consistent with existing subdirectory names.


Works for me.  I was definitely on the fence between the two.

David J.

pgsql-hackers by date:

Previous
From: Tatsuo Ishii
Date:
Subject: Re: documentation structure
Next
From: Corey Huinker
Date:
Subject: Re: Statistics Import and Export