Re: [DOCS] Stats views and functions not in order? - Mailing list pgsql-hackers

From Alvaro Herrera
Subject Re: [DOCS] Stats views and functions not in order?
Date
Msg-id 20230201092634.fpemltru6igv2ndm@alvherre.pgsql
Whole thread Raw
In response to Re: [DOCS] Stats views and functions not in order?  (Peter Smith <smithpb2250@gmail.com>)
List pgsql-hackers
On 2023-Jan-30, Peter Smith wrote:

> On Fri, Jan 27, 2023 at 10:30 PM Peter Eisentraut
> <peter.eisentraut@enterprisedb.com> wrote:

> > We could change the chunking boundary to be sect2 globally.  This is
> > easily configurable (chunk.section.depth).

> > Thinking about it now, maybe this is what we need.  As the documentation
> > grows, as it clearly does, the depth of the structure increases and
> > pages get longer.  This can also be seen in other chapters.

> This chunk configuration idea sounds a better approach. If somebody
> else wants to champion that change separately then I can maybe help to
> review it.

Changing the chunking depth will change every single doc URL, though, so
the website will need some work to ensure there's a good transition
mechanism for the "this page in older/newer versions" functionality.

It sounds doable, but someone will need to craft it and test it.  (Maybe
it would work to populate a table with all URLs at each side of the
divide, and its equivalent at the other side.)

-- 
Álvaro Herrera               48°01'N 7°57'E  —  https://www.EnterpriseDB.com/



pgsql-hackers by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: [PATCH] New [relation] option engine
Next
From: Nikolay Shaplov
Date:
Subject: Re: [PATCH] New [relation] option engine