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.5/release-notes/#v3.5.1](https://www.dita-ot.org/3.5/release-notes/#v3.5.1).

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

7. Publish 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.3..
   

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

   ./gradlew
   

5. Run the site build task in the docs repo, output to dita-ot.github.io/dev.

   ./gradlew site -PoutputDir=~/dita-ot.github.io/dev
   

   (For more information, see Building site output in the project website README.)

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)
6. Update the dita-ot Homebrew formula and open a pull request in homebrew-core.
7. Add release date to Release Notes on develop branch.