For Committers - Atmosphere/atmosphere GitHub Wiki

Committer How To

Release Manager

  • 2.0.x: JeanFrançois Arcand (end of life)
  • 2.1.x: Sebastian Lövdahl (end of life)
  • 2.2.x: Aki Yoshida (end of life)
  • 2.3.x: JeanFrançois Arcand

How to cut a release

Pre-release Announcement

First, send an email to the mailing list asking the community to test current SNAPSHOT if it's a dot dot release (2.2.x), or an RC if it's a major release (2.x). Give the community 24 hours.

If you release atmosphere-runtime, please make sure you also release atmosphere-samples with this new version.

Post-release Announcement

Send an email to the mailing list describing which module/project has been released: Atmosphere, NettoSphere, atmosphere-samples, etc with their respective changelog. The changelog can be generated using the issues labelled for that release.

Documentation

  • Each README.md of each project needs to be updated, including the changelog section.
  • script/javadoc.sh must be run to update the Javadoc

Commits

  • All commits on dot dot branches MUST have an associated issue.

Proposal for Git Commit

  • Consider starting the commit message with an applicable emoji:
    • :lipstick: :lipstick: when improving the format/structure of the code
    • :racehorse: :racehorse: when improving performance
    • :non-potable_water: :non-potable_water: when plugging memory leaks
    • :memo: :memo: when writing docs
    • :penguin: :penguin: when fixing something on Linux
    • :apple: :apple: when fixing something on Mac OS
    • :checkered_flag: :checkered_flag: when fixing something on Windows
    • :bug: :bug: when fixing a bug
    • :fire: :fire: when removing code or files
    • :green_heart: :green_heart: when fixing the CI build
    • :white_check_mark: :white_check_mark: when adding tests
    • :lock: :lock: when dealing with security
    • :arrow_up: :arrow_up: when upgrading dependencies
    • :arrow_down: :arrow_down: when downgrading dependencies