Releasing

Before release

Please consult our ISO documentation about the general procedures.

Go trough the following procedures to release Enonic XP:

Make sure you do not have uncommitted code (git status)
Switch to the release branch (git checkout <branch>)
Pull latest changes from remote (git pull)
Build the code using the clean option (./gradlew clean build)
Update gradle.properties with the release version
Commit the changes with release message (git commit -am "Released vX.X.X")
Tag the release (git tag vX.X.X)
Publish the artifacts to remote repository (./gradlew clean build uploadArchives --refresh-dependencies / publish)
Update gradle.properties with next snapshot version
Commit the changes with next snapshot message (git commit -am "Updated to next SNAPSHOT version")
Push the changes (with tags) to github (git push origin <branch> --tags)
Merge changes to master

Milestone and release candidate releases can use a simplified procedure.

Make sure you do not have uncommitted code (git status)
Switch to the release branch (git checkout <branch>)
Pull latest changes from remote (git pull)
Tag the release (git tag vX.X.X-[RC/M/B]Y)
Build release and publish to remote repository (./gradlew -Pversion=X.X.X-[RC/M/B]Y clean build uploadArchives) - (publish for 7.0 and apps.)
Push the changes (with tags) to github (git push origin <branch> --tags)

Add release notes to the release tag in GitHub.

Set the release-title to Enonic XP <release version>
Generate the changelog from GitHub using the {{generate-changelog}} command in the "release-tools" project.
Read through and verify that all entries should be there.
Copy the resulting changelog file to the release tag.

When the release is done, we have to update the following: