Date: Fri, 17 May 2019 10:18:15 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Michael Paquier <michael@paquier.xyz>
Cc: Peter Geoghegan <pg@bowt.ie>, Alvaro Herrera <alvherre@2ndquadrant.com>,
	Amit Langote <Langote_Amit_f8@lab.ntt.co.jp>,
	David Rowley <david.rowley@2ndquadrant.com>,
	"Jonathan S. Katz" <jkatz@postgresql.org>,
	PostgreSQL Advocacy <pgsql-advocacy@lists.postgresql.org>
Subject: Re: PostgreSQL 12: Feature Highlights
Message-ID: <20190517141815.vagtjaowhc54wj64@momjian.us>
References: <20190516182628.kbkiajfnlooocgyg@momjian.us>
 <20190516190806.GA14121@alvherre.pgsql>
 <CAH2-WzkkJWHiY-Uqmd4L2L5YKiPDW02ach478KXb12gmFcQGtg@mail.gmail.com>
 <20190516235250.GD20887@paquier.xyz>
 <CAH2-WznHtAuCcRMrNcocKNy1vN4w4e88d2XCT1fMMFnzjd-KiA@mail.gmail.com>
 <20190517013255.bera5dtuii376lae@momjian.us>
 <CAH2-Wz=-oSfmcjQz6h44+kBZh4Kscb74S0BAygA_aGpojVTGRw@mail.gmail.com>
 <20190517022135.xbzd4teyklkosglk@momjian.us>
 <20190517035012.GL20887@paquier.xyz>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20190517035012.GL20887@paquier.xyz>
User-Agent: NeoMutt/20170113 (1.7.2)
Precedence: bulk

On Fri, May 17, 2019 at 12:50:12PM +0900, Michael Paquier wrote:
> On Thu, May 16, 2019 at 10:21:35PM -0400, Bruce Momjian wrote:
> > I think we expect people to read them fully because how would they know
> > what changed and what new features were added.  I do think allowing more
> > detail by showing the commit messages would be helpful for people who
> > want to drill down on an item.
> 
> This point is interesting.  The release notes include in the sgml
> sources references to the related commits.  Could it make sense to
> have links to the main commits of a feature which can be clicked on
> directly from the html docs or such?  I understand that producing the
> notes is a daunting task already, and Bruce does an awesome job.  Just
> wondering if we could make that automated in some way if that helps
> with the user experience...  Anyway, this is unrelated to the topic of
> this thread.  My apologies for the digression.

Yes, I am sure it can be done.  The commits are always in a the same
style as output by src/tools/git_changelog, and always to the far left.
This has been discussed before, but no one felt it was urgent enough.

The good news is that once we do this, all release notes, even the
previous ones, will have this feature.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +