Improve documentation

[patritzenfeld]

There's multiple functions which should be explained in more detail. Also, some of the explanations are too high level, which is not good if bachelor students are supposed to use this library.

[patritzenfeld]

Some usage examples for most of the functions would also be nice.

[patritzenfeld]

Updated all end user functions with examples.

Still need to sharpen the description text a bit.