css style fixes for docs
Docstring format updates.
Top level README updates.