You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by Apache Wiki <wi...@apache.org> on 2007/05/01 16:25:16 UTC
[Db-derby Wiki] Update of "ReleaseNoteProcess" by BryanPendleton
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Db-derby Wiki" for change notification.
The following page has been changed by BryanPendleton:
http://wiki.apache.org/db-derby/ReleaseNoteProcess
------------------------------------------------------------------------------
## page was renamed from DerbyReleaseNoteProcess
Good release notes are essential for users as they upgrade from one release to the next. Here's the procedure the Derby team uses to maintain useful release notes:
- * Edit the JIRA issue to check the "release note needed" checkbox
- * Add a comment to the JIRA issue, with the information as suggested by ReleaseNoteFormat
- * Somebody intends to run some sort of a JIRA report at some point, collect up all these special comments, and edit them into a simple document.
+ * For JIRAs which need a release note, you should turn on the "Release Note Needed" flag and attach a file called "releaseNote.html".
+ * The template for releaseNote.html will live in tools/release/templates/releaseNote.html.
+ * As you improve the wording of your release note, you simply attach a new version of releaseNote.html. The release documentation will include the last version of the release note.
+ Some additional discussion regarding this process can be found in DERBY-2570.
+
Re: [Db-derby Wiki] Update of "ReleaseNoteProcess" by BryanPendleton
Posted by Rick Hillegas <Ri...@Sun.COM>.
Thanks, Bryan!
Apache Wiki wrote:
> Dear Wiki user,
>
> You have subscribed to a wiki page or wiki category on "Db-derby Wiki" for change notification.
>
> The following page has been changed by BryanPendleton:
> http://wiki.apache.org/db-derby/ReleaseNoteProcess
>
> ------------------------------------------------------------------------------
> ## page was renamed from DerbyReleaseNoteProcess
> Good release notes are essential for users as they upgrade from one release to the next. Here's the procedure the Derby team uses to maintain useful release notes:
>
> - * Edit the JIRA issue to check the "release note needed" checkbox
> - * Add a comment to the JIRA issue, with the information as suggested by ReleaseNoteFormat
> - * Somebody intends to run some sort of a JIRA report at some point, collect up all these special comments, and edit them into a simple document.
> + * For JIRAs which need a release note, you should turn on the "Release Note Needed" flag and attach a file called "releaseNote.html".
> + * The template for releaseNote.html will live in tools/release/templates/releaseNote.html.
> + * As you improve the wording of your release note, you simply attach a new version of releaseNote.html. The release documentation will include the last version of the release note.
>
> + Some additional discussion regarding this process can be found in DERBY-2570.
> +
>