Re: documentation structure - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: documentation structure
Date
Msg-id CAKFQuwZhikLAfG9ntU-611adW0AnnPFJ_wx7Hy3Lb_v7M7x27Q@mail.gmail.com
Whole thread Raw
In response to Re: documentation structure  (Tatsuo Ishii <ishii@postgresql.org>)
Responses Re: documentation structure
Re: documentation structure
List pgsql-hackers
On Thu, Jul 18, 2024 at 8:06 PM Tatsuo Ishii <ishii@postgresql.org> wrote:
> I'm opposed to having a separate file for every function. I think
> breaking up func.sgml into one piece per sect1 is about right. If that
> proves cumbersome still we can look at breaking it up further, but
> let's start with that.

That will create at least 30 func-xx.sgml files.

t-ishii$ grep '<sect1' func.sgml|wc -l
30

I am afraid that's too many?


The premise and the resultant number of files both seem reasonable to me.  I could get that number down to maybe 20 if pressed but I don't see any benefit to doing so. I look at a page on the website that needs updating then go open its source file.  Nice and tidy.

David J.

pgsql-hackers by date:

Previous
From: Alexander Lakhin
Date:
Subject: Re: Should consider materializing the cheapest inner path in consider_parallel_nestloop()
Next
From: Etsuro Fujita
Date:
Subject: Re: d844cd75a and postgres_fdw