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

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Joe Hellerstein's "Looking Back at Postgres" paper
Date: 2024-07-04 15:14:35
Message-ID: 609DE351-33C3-4BBD-BEEF-7515DF68A1A0@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 4 Jul 2024, at 17:12, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>
> Daniel Gustafsson <daniel(at)yesql(dot)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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2024-07-04 17:25:07 Re: Chapter "8.8 Geometric Types" of documentation could contain more details
Previous Message Tom Lane 2024-07-04 15:12:02 Re: Joe Hellerstein's "Looking Back at Postgres" paper