Re: [DOCS] Stats views and functions not in order?
David G. Johnston <david.g.johnston@gmail.com>
From: "David G. Johnston" <david.g.johnston@gmail.com>
To: Peter Smith <smithpb2250@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2022-11-16T21:46:41Z
Lists: pgsql-hackers
On Tue, Nov 15, 2022 at 6:39 PM Peter Smith <smithpb2250@gmail.com> wrote: > > I was also wondering (but have not yet done) if the content *outside* > the tables should be reordered to match the table 28.1/28.2 order. > > Thoughts? > > I would love to do away with the ToC listing of view names in 28.2 altogether. Also, make it so each view ends up being its own separate page. The name of the views in the table should then be the hyperlinks to those pages. Basically the way Chapter 54.1 works. Though the interplay between the top Chapter 54 and 54.1 is a bit repetitive. https://www.postgresql.org/docs/current/views.html I wonder whether having the table be structured but the ToC be purely alphabetical would be considered a good idea... The tables need hyperlinks regardless. I wouldn't insist on changing the ordering to match the table, especially with the hyperlinks, but I also wouldn't reject it. Figuring out how to make them one-per-page would be time better spent though. David J.
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