Feedback-ID: i131946ab:Fastmail
Message-ID: <539d5720-01ce-3969-4c9f-1372af98b16c@enterprisedb.com>
Date: Mon, 2 Jan 2023 09:17:28 +0100
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0)
 Gecko/20100101 Thunderbird/102.6.0
Subject: Re: [DOCS] Stats views and functions not in order?
Content-Language: en-US
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>
References: <CAHut+Pv8Oa7v06hJb3+HzCtM2u-3oHWMdvXVHhvi7ofB83pNbg@mail.gmail.com>
 <CAHut+Pv=tk6u2MbvqfSdD74HRKpV2QP+e=p0X=g7t6Bf23531w@mail.gmail.com>
 <CAKFQuwYtjTbYUs+bLUCk7aszXq_rHx0Fj=0e0fiaVKyDZ9k0Yw@mail.gmail.com>
 <CAHut+PvkAp4AS03U08uPWjOoAY+zxD1j43xhRH0TUqzuOMx2BQ@mail.gmail.com>
 <CAKFQuwa9JtoCBVc6CJb7NC5FqMeEAy_A8X4H8t6kVaw7fz9LTw@mail.gmail.com>
 <CAHut+Pv5Efz1TLWOLSoFvoyC0mq+s92yFSd534ctWSdjEFtKCw@mail.gmail.com>
 <CAKFQuwYkM5UZT+6tG+NgZvDcd5VavS+xNHsGsWC8jS-KJsxh7w@mail.gmail.com>
 <CAHut+PvUdTdK5UGMXkm_U+1Cdez9y6x057GTrb3XSChybjdS3w@mail.gmail.com>
 <cfdb0030-8f62-ed6d-4246-8d9bf855bc48@enterprisedb.com>
 <CAKFQuwbQHgBJ4zSA_oKfO6qKvy3S16hx0HuMQGpxmm53MEQJqg@mail.gmail.com>
 <CAHut+PvYpLyEGrw=6gnakU7xNfAWHeNKqFbcDghfSjOdDutTjQ@mail.gmail.com>
 <CAKFQuwYUCsugVg5cOgezh52W_2MwqMewXkr79DnxUVJ3Cs2dvA@mail.gmail.com>
 <CAKFQuwby7xWHek8=6UPaNXrhGA-i0B2zMOmBoGHgc4yaO8NH_w@mail.gmail.com>
 <CAHut+PuHhrBrYQ2cWkRuAuN6S1mAo0iEsnJSHcfOXazkF8xE8g@mail.gmail.com>
From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
In-Reply-To: <CAHut+PuHhrBrYQ2cWkRuAuN6S1mAo0iEsnJSHcfOXazkF8xE8g@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Archived-At: <https://www.postgresql.org/message-id/539d5720-01ce-3969-4c9f-1372af98b16c%40enterprisedb.com>
Precedence: bulk

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.