Restructure documentation.

Fixed some typos, rewrote some paragraphs. Removed documentation for
features that will no longer exist (see issue 146).
In progress.