Documentation Review

[gaperton]

The development job is done, all we need it to create the beautiful docs.

Any help (reviews, edits, contributions, ideas, suggestions) would be highly appreciated.