Write out release instructions as a bullet pointed list
A public release how-to (usually consisting of a bullet-pointed list) allows all maintainers to have the ability to publish a release of the new version of the package by following straightforward steps.
This allows the release procedure to be evaluated & commented on by contributors.
For example:
It would be easier for me to comment on how to avoid some of the issues related I've most recently commented on in #20 if these instructions were made explicit. It's hard for me to do more than guess about what went wrong because I can't work off of that document.
@sbassi
Could you document how you are doing your releases? It will help me diagnose why your 0.8.1 package is not working correctly on legacy pypi.
Yes, in the next release I will make notes.