Updated documentation

- Added a longer synopsis to the documentation.
- Fixed a formatting issue, renamed a header and added some more context
  to each of the examples.