Include a section about class-level documentation to the manual

[jesper-friis]

The documentation should include:

• what we mean with class-level documentation
• example of when you would need class-level documentation (e.g. reusable workflow descriptions)
• example of class-level documentation