public inbox for [email protected]
help / color / mirror / Atom feedFrom: Tom Lane <[email protected]>
To: Peter Smith <[email protected]>
Cc: PostgreSQL Hackers <[email protected]>
Subject: Re: [DOCS] Stats views and functions not in order?
Date: Sun, 06 Nov 2022 13:50:32 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <CAHut+PsvkhrByTmR=pY4K28FfUuuM9fQiKdyHHquDRLVBAj5dg@mail.gmail.com>
References: <CAHut+Pv8Oa7v06hJb3+HzCtM2u-3oHWMdvXVHhvi7ofB83pNbg@mail.gmail.com>
<CAHut+PvjbV5T4H6vk6=hPrU0iZ2KYx39cxS=xJtUL=Mu6H+t6Q@mail.gmail.com>
<CAHut+PsXR6Fq-Ra2VNUA1ZYi6MncB9de40v+tju9JmqZx00t5g@mail.gmail.com>
<CAHut+PtkV5is3+ZpJRmkZQDvdfFiC+BeBS02xQLNk_xRnfs9=A@mail.gmail.com>
<CAHut+PsvkhrByTmR=pY4K28FfUuuM9fQiKdyHHquDRLVBAj5dg@mail.gmail.com>
Peter Smith <[email protected]> writes:
> Sorry, I forgot the attachments in the previous post. PSA.
I spent a bit of time looking at this. I agree that a lot of the
current ordering choices here look like they were made with the
advice of a dartboard, and there's a number of things that are
pretty blatantly just sloppy merging (like the out-of-order
wait-event items). However, I'm not a big fan of "alphabetical
order at all costs", because that frequently leads to ordering
decisions that are not a lot better than random from a semantic
standpoint. For example, I resist the idea that it's sensible
to put pg_stat_all_indexes before pg_stat_all_tables.
I'm unconvinced that putting pg_stat_sys_tables and
pg_stat_user_tables far away from pg_stat_all_tables is great,
either.
So ... how do we proceed?
One thing I'm unhappy about that you didn't address is that
the subsection ordering in "28.4. Progress Reporting" could
hardly have been invented even with a dartboard. Perhaps it
reflects development order, but that's a poor excuse.
I'd be inclined to alphabetize by SQL command name, but maybe
leave Base Backup to the end since it's not a SQL command.
regards, tom lane
view thread (23+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected]
Subject: Re: [DOCS] Stats views and functions not in order?
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox