RELEASING 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. Release process
  2. ===============
  3. 1. Check CI
  4. * CircleCI: https://circleci.com/gh/nanomsg/nanomsg/tree/master
  5. * AppVeyor: https://ci.appveyor.com/project/nanomsg/nanomsg
  6. 2. Bump ABI version as appropriate (see the docs on versioning). This happens
  7. in src/nn.h, check links there on which numbers to update.
  8. 3. Bump the version in the .version file, such as 0.10-beta or 1.0 or
  9. whatever. This should match the tag you are going to use.
  10. 4. Commit and push both of the above changes back to the public repo.
  11. 5. Tag the new version, e.g. git tag -a 0.3-beta. (Make sure to use -a
  12. to create an annotated tag.)
  13. 6. Push the tag to the repo, e.g. git push origin 0.3-beta.
  14. 7. Wait a little bit for CI to build.
  15. 8. Check the AppVeyor CI again just to be sure.
  16. 9. Check the github releases page - a release for the tag should have
  17. already been created with artifacts ready to download.
  18. 10. Update the _config.yml page on the website (see gh-pages branch of the
  19. repo). The only thing that needs to be updated is the "latest" and
  20. "latest_date".
  21. 11. In the online docs (gh-pages branch), copy the man pages (adoc format)
  22. into a subdirectory of _adoc named after the version (e.g.
  23. "_adoc/v1.1.3"), then run the _adoc/build.sh script. Add the resulting
  24. "v1.1.3" directory, commit, and push.
  25. 12. Send the announcement about the release. These commands might be useful:
  26. git log --oneline 0.2-alpha..0.3-beta | wc -l
  27. git diff -U0 0.2-alpha..0.3-beta AUTHORS
  28. 13. Update the topic in the Gitter chatroom accordingly.