Move VERSION_NUMBER note to where it is relevant
Fix incorrect alt text for version badge examples
Add alt text for rst examples (like md examples)
Unindent double-indented rst examples
Merge pull request #1 from treyhunner/fix-docs

Some documentation improvements