Add code gallery with examples to documentation

The documentation should have a section with real-life code examples. The code should live somewhere in the documentation, it should not be imported into the namespace.

• The generated Sphinx documentation includes code examples from some location.
• There is at least one example, which also has a test.
• Minimal testing solution: There is a Makefile which runs all tests.