Re: [DOCS] Stats views and functions not in order?

vignesh C <vignesh21@gmail.com>

From: vignesh C <vignesh21@gmail.com>
To: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
Cc: Peter Smith <smithpb2250@gmail.com>, "David G. Johnston" <david.g.johnston@gmail.com>, Tom Lane <tgl@sss.pgh.pa.us>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2023-01-04T07:07:59Z
Lists: pgsql-hackers
On Mon, 2 Jan 2023 at 13:47, Peter Eisentraut
<peter.eisentraut@enterprisedb.com> wrote:
>
> On 08.12.22 03:30, Peter Smith wrote:
> > PSA patches for v9*
> >
> > v9-0001 - Now the table rows are ordered per PeterE's suggestions [1]
>
> committed
>
> > v9-0002 - All the review comments from DavidJ [2] are addressed
>
> I'm not sure about this one.  It removes the "see [link] for details"
> phrases and instead makes the view name a link.  I think this loses the
> cue that there is more information elsewhere.  Otherwise, one could
> think that, say, the entry about pg_stat_activity is the primary source
> and the link just links to itself.  Also keep in mind that people use
> media where links are not that apparent (PDF), so the presence of a link
> by itself cannot be the only cue about the flow of the information.

I'm not sure if anything is pending for v9-0003, if there is something
pending, please post an updated patch for the same.

Regards,
Vignesh



Commits

  1. doc: Re-order Table 28.2 "Collected Statistics Views"

  2. doc: Re-order Table 28.35 "Per-Backend Statistics Functions"

  3. doc: Re-order Table 28.12 "Wait Events of type LWLock"

  4. doc: Re-order sections of "28.4. Progress Reporting"