Rewrite README and include as "about" in docs

That may be true... Sounds right. But... You asked for consistency with Python.

It isn't necessarily true that pages are stand–alone. reStructuredText allows for substitutions and inclusions. This introduces dependencies.

[Python's convention](http://sphinx-doc.org/rest.html#sections) doesn't describe only a succession—it assigns specific roles: `#` (with overline) is *for parts*, `*` (with overline) is *for chapters* and so on.

And, I guess that the structure of documentation is far less subject to change and far more easy to change than program code.