readme release info, badges
-[![Travis Build Status](https://travis-ci.org/googlefonts/nototools.svg)](https://travis-ci.org/googlefonts/nototools)
+[![Travis Build Status](https://travis-ci.org/googlefonts/nototools.svg?branch=master)](https://travis-ci.org/googlefonts/nototools)
+[![PyPI](https://img.shields.io/pypi/v/nototools.svg)](https://pypi.org/project/nototools/)
+[![pyup](https://pyup.io/repos/github/googlefonts/nototools/shield.svg)](https://pyup.io/repos/github/googlefonts/nototools)
# Noto Tools
@@ -44,3 +46,24 @@ The following scripts are provided:
The following tools are provided:
* `notodiff`
+
+## How to cut a new release
+
+Use `git tag -a` to make a new annotated tag, or `git tag -s` for a GPG-signed annotated tag,
+if you prefer.
+
+Name the new tag with with a leading 'v' followed by three MAJOR.MINOR.PATCH digits, like in
+[semantic versioning](https://semver.org/). Look at the existing tags for examples.
+
+In the tag message write some short release notes describing the changes since the previous
+tag.
+
+Finally, push the tag to the remote repository (e.g. assuming upstream is called `origin`):
+
+```
+$ git push origin v0.4.3
+```
+
+This will trigger the CI to build the distribution packages and upload them to the
+[Python Package Index](https://pypi.org/project/nanoemoji/) automatically, if all the tests
+pass successfully.
