Readme edits, fixes #1

An extremely detailed description.