Re: Detailed release notes

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
Cc: jian he <jian(dot)universality(at)gmail(dot)com>, Jelte Fennema-Nio <postgres(at)jeltef(dot)nl>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Daniel Gustafsson <daniel(at)yesql(dot)se>, PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Detailed release notes
Date: 2024-09-14 13:44:14
Message-ID: ZuWTLtZMiSO_VaJU@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Fri, Sep 13, 2024 at 05:54:31PM -0400, Bruce Momjian wrote:
> On Fri, Sep 13, 2024 at 06:41:30PM -0300, Marcos Pegoraro wrote:
> > Em sex., 13 de set. de 2024 às 13:39, Bruce Momjian <bruce(at)momjian(dot)us>
> > escreveu:
> >
> > I changed the patch to use the section symbol "§" instead of showing
> > the hashes.  The hashes seemed too detailed.  Does anyone see a better
> > symbol to use from here?
> >
> >
> > Robert and others liked commit hashes because you can do "git show $COMMITID"
>
> We have to consider the small percentage of people who will want to do
> that vs the number of people reading the release notes. I think it is
> reasonable to require someone to click on the link to see the hash.

Thinking some more, I think that displaying the hashes would give the
average reader the impression that the release notes are too complex for
them to understand.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

When a patient asks the doctor, "Am I going to die?", he means
"Am I going to die soon?"

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Andrew Dunstan 2024-09-14 14:22:11 Re: Robocopy might be not robust enough for never-ending testing on Windows
Previous Message Bruce Momjian 2024-09-14 13:38:46 Re: First draft of PG 17 release notes