DOC: update release docs

Makefile

@@ -106,4 +106,5 @@ push-docs: docs
 
 push-pypi: clean
 	python setup.py sdist
+	# Note: if this fails, add '-p PASSWORD'
 	twine upload -u gramener dist/*

README.rst

@@ -7,7 +7,7 @@ data-based web apps with less code.
 Gramex takes a component based approach building data apps. (Like LEGO bricks.)
 This needs fewer steps, takes less time, and builds apps with fewer bugs.
 
-`Examples of public data apps built on Gramex <https://gramener.com/demo>`_
+`Examples of public data apps built on Gramex <https://gramener.com/demo/>`_
 
 Gramex supports a wide varied of visualizations to choose from.
 
@@ -24,7 +24,7 @@ Technology
 ----------
 
 Gramex is built on top of Python, Node.js, R and their ecosystem of libraries.
-`See full list <https://learn.gramener.com/guide/license/thirdparty.md>`.
+`See full list <https://learn.gramener.com/guide/license/thirdparty.md>`_.
 
 Gramex supports 50+ data sources. This includes most relational databases
 supported by
@@ -35,13 +35,16 @@ supported by
 Contributing
 ------------
 
-- Need help?
-  `Browse the issues <https://code.gramener.com/cto/gramener/gramex/issues>`_
-- Want to report a bug or request a feature?
-	`Open an issue <https://code.gramener.com/cto/gramex/issues/new>`_.
-	If it is a security issue, please email to security@gramener.com, rather
-	than publicly sharing the vulnerability.
-- Want to fix a bug or add a feature? Fork it, make changes, and send a pull request.
+**Need help?**
+`Browse the issues <https://code.gramener.com/cto/gramener/gramex/issues>`_
+
+**Want to report a bug or request a feature?**
+`Open an issue <https://code.gramener.com/cto/gramex/issues/new>`_.
+If it is a security issue, please email to security@gramener.com, rather
+than publicly sharing the vulnerability.
+
+**Want to fix a bug or add a feature?**
+Fork it, make changes, and send a pull request.
 
 
 License

gramex/apps/guide/contributing/README.md

@@ -122,7 +122,7 @@ Merge with master, create an annotated tag and push the master branch:
 ```bash
 git checkout master
 git merge dev
-git tag -a v1.x.x           # Annotate with a one-line summary of features
+git tag -a v1.x.x -m"One-line summary of features"
 git push --follow-tags
 git checkout dev            # Switch back to dev
 git merge master