Re: Joe Hellerstein's "Looking Back at Postgres" paper

Daniel Gustafsson <daniel@yesql.se>

From: Daniel Gustafsson <daniel@yesql.se>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: pgsql-docs@lists.postgresql.org
Date: 2024-07-04T15:14:35Z
Lists: pgsql-docs
> On 4 Jul 2024, at 17:12, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> 
> Daniel Gustafsson <daniel@yesql.se> writes:
>> Unrelated to that, but reading history.sgml I found this sentend at the end of
>> the page to be sort of misleading:
> 
>> "Details about what has happened in PostgreSQL since then can be found
>> in Appendix E."
> 
>> While technically true, it seems a bit overpromising in a history section to
>> refer to the release notes which are written in a very different way from the
>> prose here (and the release notes are not even in Appendix E anymore).
> 
> Well, it made sense with our old practice of including all the notes
> back to 1996 in appendix E.

Yup, and I'm glad we don't anymore.

> But now, not so much.  The simplest fix would be to change this text to point to
> 
> https://www.postgresql.org/docs/release/

Agreed.  I would probably reword that to say "Details about what has happened
in each PostgreSQL release since.." while at it.

--
Daniel Gustafsson




Commits

  1. Doc: minor improvements for our "Brief History" chapter.