Thanks Stefan for the thoughts and Jiajia for the consideration. JIRA will give us the complete list resolved during the span as good inputs for manually writing of the RN. This way makes more sense to Kerby and major releases because it's a new project and we'd better focus on the features we've come up. For minor releases and mature projects like Studio, a bug fix list sounds great.
Regards, Kai -----Original Message----- From: Li, Jiajia [mailto:[email protected]] Sent: Monday, January 18, 2016 3:53 PM To: [email protected] Subject: RE: About release note So I will pick out the features and important changes in the generated RN. And some commits without creating the JIRA, I will check the git commit logs for RN. Ps: The title of issue should be more meaningful when created in the feature development. Thanks Jiajia -----Original Message----- From: Li, Jiajia [mailto:[email protected]] Sent: Monday, January 18, 2016 3:34 PM To: [email protected] Subject: RE: About release note Thanks for Stefan's advises, I also think the JIRA generated RN is not very well. And the method to generate RN help me a lot. Thanks Jiajia -----Original Message----- From: Stefan Seelmann [mailto:[email protected]] Sent: Monday, January 18, 2016 2:56 PM To: [email protected] Subject: Re: About release note On 01/17/2016 11:33 PM, Zheng, Kai wrote: > Hi, > > From users' point of view, for a release, they may want to know what's > exactly released. I reviewed the release process and artifacts for the first > one RC1, it looks like we're not clear about this. So come to the upcoming > RC2 release, how to distinguish it from the before? I guess we'll need to > document well, having something like release note or history. We'll need to > sort out what features to include in the list that we claim they're ready and > available for use or experimental. Just some thoughts, and welcome feedback. > Thanks. In other Directory projects we use Jira to generate RN. If you go to "Change Log" [1] or "Road Map" [2] you see the versions, the included issues, and there is also a link "Release Notes". This requires that the "Fix versions" field is properly maintained. We then take those RN and put it into the announce mail and on the website [3][4]. However I'm not always happy with what Jira generates. Often the issue title is not really descriptive. And issues like "Fix findbugs problem" is not interesting from a user POV. But at least you can use it as base for a hand-written release notes. Kind Regards, Stefan [1] https://issues.apache.org/jira/browse/DIRKRB?selectedTab=com.atlassian.jira.jira-projects-plugin:changelog-panel [2] https://issues.apache.org/jira/browse/DIRKRB?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel [3] https://directory.apache.org/api/news.html [4] https://directory.apache.org/studio/news.html
