Add proper user documentation

Currently our documentation is very basic - only the README - and doesn't cover all commands nor provide much examples.

We need to improve this so it's easier for someone who wants to use the tool. The docs could have:

- Explanation and examples for all commands
- Examples of specific uses - eg. prepare a release