Date: Sat, 14 Sep 2024 09:44:14 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Marcos Pegoraro <marcos@f10.com.br>
Cc: jian he <jian.universality@gmail.com>,
	Jelte Fennema-Nio <postgres@jeltef.nl>,
	Tom Lane <tgl@sss.pgh.pa.us>, Daniel Gustafsson <daniel@yesql.se>,
	PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: Detailed release notes
Message-ID: <ZuWTLtZMiSO_VaJU@momjian.us>
References: <1673965.1722003082@sss.pgh.pa.us>
 <ZsPC8FoTFeW9PP0n@momjian.us>
 <CAB-JLwY8hJ=N4G_kePkkR87CdQdAkL9MDAgFwP+WM7_dP7MgOQ@mail.gmail.com>
 <2043874.1724347651@sss.pgh.pa.us>
 <CAB-JLwbX-P3_c+FS=FgPrAPMojpTZEno6eQnDg1Aa7zWtOqyng@mail.gmail.com>
 <CAGECzQRoz1dqyBc+0M48tzwYDbO-hYbXyVN8_AH9rfO436unqA@mail.gmail.com>
 <CACJufxF+9YCDce5vzmZY6ZCEeTJsYFG-kPohT9UjKikJX30mGw@mail.gmail.com>
 <ZuRqwGUbVltayZon@momjian.us>
 <CAB-JLwZ1Td7v3G_9Vz2QhuQeQzQwn-xm2jePeEZtoKfXh31mKg@mail.gmail.com>
 <ZuS0lz1-F7VP80yR@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <ZuS0lz1-F7VP80yR@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/ZuWTLtZMiSO_VaJU%40momjian.us>
Precedence: bulk

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