Documentation typos and expanded examples

[Stefan-Endres]

Fix the typos in the documentation found here and improve the readability as well as detailing the use of the arguments inside the algorithm #27.

The examples should also include usage of advanced features such as the symmetry argument of the algorithm to increase visibility.

[Stefan-Endres]

Fixed.