Add examples to class and function documentation

For exported classes and functions, there should be an example tag in the documentation so the user knows how to call them

mentioned in merge request !11 (merged)

mentioned in commit d08c2332

closed with merge request !11 (merged)