README.md: improve installation instructions
document all commands

Well almost all, some have been left out:

- rewrite commands because they will soon be remove
- log command because they will soon change significantly.

Aside from those now at least every command has a doc-string.
Merge branch 'pr/docs'