[jira] [Comment Edited] (HBASE-14175) Adopt releasedocmaker for better generated release notes

["Andrew Purtell (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/HBASE-14175?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14648455#comment-14648455 ] 

Andrew Purtell edited comment on HBASE-14175 at 7/30/15 11:09 PM:
------------------------------------------------------------------

According to Allen, we can generate release notes for all releases in a range to bootstrap:

{noformat}
releasedocmaker.py --license --projecttitle "Apache HBase" --index --project HBASE \
  --range --version 0.98.0 --version 2.0.0
{noformat}

Could do this by hand, update one of the site sources to point to where the generated relnotes land, then commit the results. 

In order to make this repeatable for RCs, we'll need to have a Yetus release to consume or temporarily take releasedocmaker.py into our dev-support/ (the latter being a poor option), then add the right magic to make_rc.sh and release HOWTO.


was (Author: apurtell):
According to Allen, we can generate release notes for all releases in a range to bootstrap:

{noformat}
releasedocmaker.py --license --projecttitle "Apache HBase" --index --project HBASE \
  --range --version 0.98 --version 2.0.0
{noformat}

Could do this by hand, update one of the site sources to point to where the generated relnotes land, then commit the results. 

In order to make this repeatable for RCs, we'll need to have a Yetus release to consume or temporarily take releasedocmaker.py into our dev-support/ (the latter being a poor option), then add the right magic to make_rc.sh and release HOWTO.

> Adopt releasedocmaker for better generated release notes
> --------------------------------------------------------
>
>                 Key: HBASE-14175
>                 URL: https://issues.apache.org/jira/browse/HBASE-14175
>             Project: HBase
>          Issue Type: Task
>            Reporter: Andrew Purtell
>             Fix For: 2.0.0
>
>
> We should consider adopting Hadoop's releasedocmaker for better release notes. This would pull out text from the JIRA 'release notes' field with clean presentation and is vastly superior to our current notes, which are simply JIRA's list of issues by fix version. Could hook it into the site build. A convenient part of Yetus to get up and running with. 



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)