+1

Thanks Anthony for starting the Release Notes page, I think it is a step in
the right direction.

I took a look at several other top-level projects and came across two
styles that I liked:
- Apache Brooklyn: http://brooklyn.apache.org/v/latest/misc/
release-notes.html
- Apache Ivy: http://ant.apache.org/ivy/history/2.4.0/release-notes.html

Brooklyn is the 'fancy' HTML-based and Ivy is the 'classic' text format,
however, both show the highlights for the release. Maybe we can pick the
top 3-5  feature/fixes/changes that can be included in the release
announcement thread as well.

--Mark

On Sat, Oct 29, 2016 at 9:32 AM, Anthony Baker <aba...@pivotal.io> wrote:

> I added a rudimentary release notes page [1] based on the information from
> the release announcements and linked to it from the website [2].
>
> @Everyone:  feel free to jump in and improve the content.
>
> Thanks,
> Anthony
>
> [1] https://cwiki.apache.org/confluence/display/GEODE/
> Release+Notes#ReleaseNotes-1.0.0-incubating <https://cwiki.apache.org/
> confluence/display/GEODE/Release+Notes#ReleaseNotes-1.0.0-incubating>
> [2] http://geode.apache.org/releases/ <http://geode.apache.org/releases/>
>
> > On Oct 27, 2016, at 3:13 PM, John Blum <jb...@pivotal.io> wrote:
> >
> > Yes, +1.
> >
> > Also, it doesn't hurt to list the significant/critical dependency updates
> > in a subsection.
> >
> > -j
> >
> > On Thu, Oct 27, 2016 at 3:10 PM, Anthony Baker <aba...@pivotal.io>
> wrote:
> >
> >> The release notes [1] from the latest release announcement [2] included
> a
> >> long list of all the JIRA’s associated with the release.  Having a
> curated
> >> list that highlights the most interesting changes would make the release
> >> more approachable and easy to understand.
> >>
> >> What do you think about providing a short release description in
> addition
> >> to the JIRA issues list?  Check out [3] for an example of doing this in
> the
> >> wiki.  We could also link to release notes from the releases [4] page.
> >>
> >>
> >> Anthony
> >>
> >> [1] https://issues.apache.org/jira/secure/ReleaseNote.jspa?
> >> projectId=12318420&version=12332343
> >> [2] https://mail-archives.apache.org/mod_mbox/www-announce/
> >> 201610.mbox/%3cCAKdRdJhGNe+4v-OUxk06dLpRDjGZHGCsgtP7dZjDsuZH
> >> rcp...@mail.gmail.com%3e
> >> [3] https://cwiki.apache.org/confluence/display/NIFI/Release+Notes
> >> [4] http://geode.apache.org/releases/
> >>
> >>
> >
> >
> > --
> > -John
> > 503-504-8657
> > john.blum10101 (skype)
>
>

Reply via email to