Release preparation

Checklist of steps to follow when preparing a new release of the DITA-OT documentation.

High-Level Process

1. Finalize docs content.

2. Use Git Flow to finish the release branch in the docs repo:

    git flow release finish RELEASE
   

   This performs the following steps automatically:

   • merges the release branch back to master
   • tags the merge commit on the master branch
   • merges the release tag into develop

3. Update the docsrc submodule pointer in the main dita-ot repo.

4. Use Git Flow to finish the release branch in the main dita-ot repo:

   git flow release finish RELEASE
   

5. Edit release on https://github.com/dita-ot/dita-ot/releases.

   For _Release Notes_, see [dita-ot.org/3.1/release-notes](http://dita-ot.org/3.1/release-notes).
   

6. Update project website (see Release preparation in the project website wiki).

7. Publish to artifacts to Sonatype.

Docs Release Process

1. Update Release Notes based on the list of resolved issues in the release milestone.

2. Increment (verify/update) version numbers in key-definitions.ditamap
   (compare w/ version setting in dita-ot build.gradle):

   • version &
   • release keys

3. Update the list of contributors for the target release based on git-extras output from dita-ot repo:

    git summary 3.1..
   

4. Run the docs build via the Gradle wrapper to generate/update the messages & parameters topics, HTML & PDF output:

   ./gradlew
   

5. Run the site.gradle build in the docs repo, output to dita-ot.github.io/dev. (For more information, see Building site output in the project website wiki.)

Post-Release Tasks

1. Close release milestone and related project.
2. Move any remaining unresolved issues to new milestone/project.
3. Remove remote release branch.
4. Update .travis.yml to use the new DITA-OT version for CI builds.
5. Update Wikipedia page with latest release info (at least for major releases)