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
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 |