README promoted back to MarkDown. Docstrings added. Minor typos corrected.