Re: Detailed release notes - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: Detailed release notes
Date
Msg-id ZuWTLtZMiSO_VaJU@momjian.us
Whole thread Raw
In response to Re: Detailed release notes  (Bruce Momjian <bruce@momjian.us>)
List 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@momjian.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@momjian.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?"



pgsql-hackers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: First draft of PG 17 release notes
Next
From: Andrew Dunstan
Date:
Subject: Re: Robocopy might be not robust enough for never-ending testing on Windows