How to make a release

This document is meant for developers that want to publish a new release.

  1. Make sure content is up-to-date.
    See Upgrade the content.

  2. Increase CARLA version where necessary.
    Increase version in the following files: DefaultGame.ini, Carla.uplugin, setup.py, ContentVersions.txt. Grep for the current version to make sure you don't miss any references.

  3. Clean up CHANGELOG.md.
    Make sure the change log is up-to-date, reword and reorganize if necessary; take into account which items can be more important to the users.

  4. Commit changes and add a new tag.
    Once all your changes are committed, add a new tag with git tag -a X.X.X (replacing X.X.X by latest version). Add the changelog of this version as tag message.

  5. Tag content repo.
    Add a similar tag to the content repository at the exact commit as in ContentVersions.txt.

  6. Push changes.
    Push all the changes to both repositories, to push tags you may need to use git push --tags. Create a Pull Request if necessary.

  7. Edit GitHub release.
    Go to GitHub releases and create a new release on top of the newly created tag. Wait until Jenkins has finished publishing the builds with the latest version and add the download links to the newly created release.