From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: bilge@scriptfusion.com
Subject: Chapter 7. Queries
Date: Fri, 11 Sep 2020 08:45:41 +0000
Message-ID: <159981394174.31338.7014519396749859167@wrigleys.postgresql.org> (raw)
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/12/queries.html
Description:
I like to browse documentation by index rather than searching. The Postgres
documentation is fairly well organized so this is easy for most topics.
However, on the "Chapter 7. Queries" index page, I often think I am in the
wrong place if I am looking for information about UNION or ORDER BY, because
those keywords are missing from that page. Unlike all the other headings,
the headings for these two topics does not include the relevant keywords in
teletype. I think it is important to include the keywords, particularly for
people whom already know which keyword they're looking for.
For example, I propose the following changes:
7.4. Combining Queries -> 7.4. Combining Queries with UNION
7.5. Sorting Rows -> 7.5. Sorting Rows with ORDER BY
If there are other examples I've missed where a topic is bound to a specific
keyword, they should updated similarly.
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: pgsql-docs@postgresql.org
Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, bilge@scriptfusion.com
Subject: Re: Chapter 7. Queries
In-Reply-To: <159981394174.31338.7014519396749859167@wrigleys.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox