Improve docstrings

Improve or created docstrings when needed.
Delete README.rst

Delete README.rst for an improve README using markdown.
Write a better README

Write a better README with installation, development, and licensing
using markdown.
Initial commit
Merge branch 'docs' into develop

Add or improved docstrings for classes and methods. Improve README and
license information.