[hibernate-dev] Changelog file in Hibernate ORM

[Gail Badner]

+1 to listing the the version prior to branching.

----- Original Message -----
> From: "Steve Ebersole" <steve at hibernate.org>
> To: "Gail Badner" <gbadner at redhat.com>
> Cc: "hibernate-dev" <hibernate-dev at lists.jboss.org>, "Hardy Ferentschik" <hardy at hibernate.org>
> Sent: Thursday, May 28, 2015 12:58:42 PM
> Subject: Re: [hibernate-dev] Changelog file in Hibernate ORM
> 
> I don't like the idea of a 5.0 change log having 4.x issues.  It kind of
> defeats the whole purpose.
> 
> As a compromise, I can see noting the last previous family release in the
> changlog.  Again using 5.0 as an example, make a note that 5.0 development
> started after 4.3.6
> On May 28, 2015 2:01 PM, "Gail Badner" <gbadner at redhat.com> wrote:
> 
> > Here is my 2 cents.
> >
> > I find it helpful that the changelog contains all jiras for all releases
> > that feed into a particular version. It makes it clear when later branches
> > were branched off.
> >
> > This is particularly helpful when we are maintaining multiple branches and
> > commits are being backported to different branches.
> >
> > My preference would be to truncate the changelogs to the point at which
> > 4.2, 4.3, and 5 branches diverge.
> >
> > For master: include everything starting form 4.3.6.Final (the last version
> > in master changelog that is also included in 4.3 changelog).
> >
> > For 4.3: include everything starting from 4.1.5.SP1 (the last version in
> > 4.3 changelog that is also included in 4.2 changelog).
> >
> > For 4.2: leave changelog.txt as is.
> >
> > This helps me track down when things are amiss (e.g., for regressions). I
> > know there are other ways to investigate things related to
> > misplaced/forgotten commits, but the changelogs have been a good starting
> > point for me.
> >
> > Gail
> >
> >
> > ----- Original Message -----
> > > From: "Hardy Ferentschik" <hardy at hibernate.org>
> > > To: "Brett Meyer" <brmeyer at redhat.com>
> > > Cc: "Hibernate" <hibernate-dev at lists.jboss.org>
> > > Sent: Thursday, May 28, 2015 1:42:05 AM
> > > Subject: Re: [hibernate-dev] Changelog file in Hibernate ORM
> > >
> > > On Wed, May 27, 2015 at 10:01:51PM -0400, Brett Meyer wrote:
> > > > +1 from me.  Although, on the other hand, do we really need to keep
> > > > maintaining that to begin with?  I guess I never thought simply having
> > > > users go to the JIRA release notes was a big deal.  Just my $.02.
> > >
> > > Same for me on both counts, the proposed handling of changelog.txt as
> > well as
> > > Brett's comment regarding the usefulness of this file altogether.
> > >
> > > --Hardy
> > >
> > >
> > > _______________________________________________
> > > hibernate-dev mailing list
> > > hibernate-dev at lists.jboss.org
> > > https://lists.jboss.org/mailman/listinfo/hibernate-dev
> > _______________________________________________
> > hibernate-dev mailing list
> > hibernate-dev at lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/hibernate-dev
> >
>