Horton

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

Peter Eisentraut <peter.eisentraut@enterprisedb.com>

View thread View on postgr.es
From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
To: Peter Smith <smithpb2250@gmail.com>, "David G. Johnston" <david.g.johnston@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2023-01-02T08:17:28Z
Lists: pgsql-hackers 
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.

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"