Update Release Notes: Difference between revisions

From MediaWiki
Jump to navigationJump to search
No edit summary
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
The release notes at SourceForge will need to be created and or updated. In general, this involves the following:
The release notes at SourceForge will need to be created and or updated. This file is generated from the template file: ''include/dist/release-notes.txt''. You should edit/view this file to make sure it looks OK for the current release.


* Create the file: "''src/sf/sf-release-notes-${VERSION}.html''" (copy an existing file to use as a starting point).
This template file will be used to produce: ''nst-RELEASE/release-notes-RELEASE.txt'' later during the release.
 
* Update the information contained in the file (MD5 sums, notes about the release, etc).
 
* Upload the release notes to SourceForge.
 
* Log into the SourceForge site and go to the file management area. Flag the newly uploaded file as a release notes document.
 
* Edit the properties for the other files uploaded for the release and associate them with the release notes document.
 
Here's example of how one might create and upload the release notes:
 
[root@nst-dev-32 repo]# cd src/sf
[root@nst-dev-32 sf]# cp sf-release-notes-2.11.0.html sf-release-notes-2.12.0.html
[root@nst-dev-32 sf]# emacs -nw sf-release-notes-2.12.0.html
... Edit release notes HTML ...
[root@nst-dev-32 sf]# make release-notes-upload
... Output related to the transfer to SourceForge ...
[root@nst-dev-32 sf]#
 
= [[Image:Warning.png‎]] Modifying Release Notes =
 
At the time of the 2.11.0 release, it was very difficult to change the release notes file at SourceForge. Here's the process that seemed to work for us:
 
* Using the SourceForge file manager, remove any associations of other files with the release notes.
* Using a '''sftp''' connection to SourceForge, remove the existing release notes file.
* From the NST development box, upload the new version of the release notes document (''make release-notes-upload'').
* Back in the SourceForge file manager rename the '''Release Notes''' file to a unique name (e.g., '''release-notes-2.11.0-2.html''') that has never been used. Current convention is to increment the subversion number. In the case: "'''-2'''" would become a "'''-3'''".
* Back in the SourceForge file manager set the ''Release Notes'' option under the file properties.
* Back in the SourceForge file manager associate the new release notes with the other files.

Latest revision as of 15:04, 6 October 2010

The release notes at SourceForge will need to be created and or updated. This file is generated from the template file: include/dist/release-notes.txt. You should edit/view this file to make sure it looks OK for the current release.

This template file will be used to produce: nst-RELEASE/release-notes-RELEASE.txt later during the release.