Various adjustments.

- Included fixes for comments made on github.

- More sphinx constructs.

- Fixed a sphinx link.

- Improved wording.