Documentation update.

Improved language and formatting, added a few links.