maintainers-guide.rst 1.4 KB

12345678910111213141516171819202122232425262728293031323334
  1. Maintainer's guide
  2. ==================
  3. Commit policy
  4. -------------
  5. * Pull requests from outside contributors require a review from a maintainer.
  6. * Maintainers should avoid working on a master branch directly and create branches for everything. A code review from another maintainer is recommended but not required, use your best judgment.
  7. Release process
  8. ---------------
  9. Releases happen on a 6-week schedule. Currently due to a long break the date of the next release is not set.
  10. * Update CHANGES.md with everything interesting since the last update.
  11. * Update version numbers using the three-part x.y.z notation everywhere:
  12. * The header in CHANGES.md (this is where the site looks for the latest version number)
  13. * ``"version"`` attribute in package.json
  14. * ``"version"`` attribute in package-lock.json (run `npm install`)
  15. * Two places in docs/conf.py (``version`` and ``release``)
  16. * Commit the version changes and tag the commit with the plain version number (no "v." or anything like that)
  17. * Push the commit and the tags to master (``git push && git push --tags``)
  18. Pushing the tag triggers the update process which can be monitored at http://highlightjs.org/api/release/
  19. When something didn't work *and* it's fixable in code (version numbers mismatch, last minute patches, etc), simply make another release incrementing the third (revision) part of the version number.