Expanded documentation. More examples, added sections based on each

major endpoint.

This includes documention on the hijacking of the "link" property in
some contexts.

Author: rouilj