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 develop & master
   • tags the merge commit on the master branch

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 complete Release Notes, see www.dita-ot.org/2.3/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 2.2..
   

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.
2. Remove remote release branch.
3. Update .travis.yml to use the new DITA-OT version for CI builds.
4. Update Wikipedia page with latest release info (at least for major releases)