Use docstrings format that appeases sphinx parser.

Reduce number of warnings in sphinx builds.
Do not include the unit tests autodocs.
Link to README.md instead of copying installation text.
Avoid warnings about missing _static directory.