Re: Joe Hellerstein's "Looking Back at Postgres" paper - Mailing list pgsql-docs

From Daniel Gustafsson
Subject Re: Joe Hellerstein's "Looking Back at Postgres" paper
Date
Msg-id 609DE351-33C3-4BBD-BEEF-7515DF68A1A0@yesql.se
Whole thread Raw
In response to Re: Joe Hellerstein's "Looking Back at Postgres" paper  (Tom Lane <tgl@sss.pgh.pa.us>)
List 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




pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Joe Hellerstein's "Looking Back at Postgres" paper
Next
From: Tom Lane
Date:
Subject: Re: Chapter "8.8 Geometric Types" of documentation could contain more details