Re: [DOCS] Stats views and functions not in order?
Alvaro Herrera <alvherre@alvh.no-ip.org>
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Peter Smith <smithpb2250@gmail.com>
Cc: Peter Eisentraut <peter.eisentraut@enterprisedb.com>, "David G. Johnston" <david.g.johnston@gmail.com>, Tom Lane <tgl@sss.pgh.pa.us>, vignesh C <vignesh21@gmail.com>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2023-02-01T09:26:34Z
Lists: 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/
Commits
-
doc: Re-order Table 28.2 "Collected Statistics Views"
- 72e0ff2677c4 16.0 landed
-
doc: Re-order Table 28.35 "Per-Backend Statistics Functions"
- b1d0158060f3 16.0 landed
-
doc: Re-order Table 28.12 "Wait Events of type LWLock"
- 9c558b94f0ca 16.0 landed
-
doc: Re-order sections of "28.4. Progress Reporting"
- 6573643501e9 16.0 landed