Release of wiki documentation
Describes the steps required to QA and baseline the documentation for a release and prepare the documentation for the next development cycle.
Documentation Structure
Unreleased documentation is always maintained in the NASDOC Confluence Space. When a release is created, this space is copied to create a new space containing the version number - eg. NASDOC44 for version 4.4 of NAS. The documentation home page contains links to the childspace of the current release as well as a link to the unreleased documentation.
Quality assurance
- Update all screenshots to reflect the new GUI. The previous attachments should be deleted before the new attachment is uploaded to avoid cluttering the disk with version controlled old attachments.
- Review all documents.
Baseline
- Create the new Space (from the "Spaces" drop-down at the very top of the page).
- Navigate to the bleeding-edge documentation page (https://kb-dk.atlassian.net/wiki/display/NASDOC/)
- Find the "Copy" link under the "..." link at the right of the page menu
- Click on "Copy" and fill in the newly-created space name
- Click to include child pages and click "Copy".
- Under "Space tools → Overview → Edit space details" set the documentation root to be the home page of the new space (also delete the old blank home page).
- In the new documentation root, go to "Space tools → Permissions" at the bottom left and update so the versioned space can be view Anonymously and commented on by all confluence-users.
- Update the Documentation page to make the children display point to the new release page.
- Add the label "nasdoc" to the new documentation root page
Add this header to the previous released documentation through the Space tools → Look and Feel
{info:icon=false}*Note that this documentation is for the old X.XX release.* For the newest documentation, please see the [current release documentation|NASDOCXXX:NetarchiveSuite documentation home].{info}
- Update the page _Major Release Number to point to the next expected release.
- Update the upcoming versions referred to by the bleeding edge documentation at https://kb-dk.atlassian.net/wiki/display/NASDOC/
- After all this is done, the following should be checked:
- The documentation page (Documentation) has links to the documentation for the just-released version
- The documentation for the just-released version has no header
- The documentation for the previously-released version now has a header with a link to the just-released version
- The bleeding-edge documentation at NetarchiveSuite documentation has a header with a link to the documentation page and refers to an upcoming release
Prepare for next development cycle
Update any specific version info in the documentation to reflect the incremented version.