Reorganize a bit the docs and add three new example models

[fwitte]

Resolves #ISSUE_NUMBER

• Implement unit tests for the changes
• Update the documentation
• For a new feature: Implement an example and a system test
• Update the changelog at docs/whats_new/*
• (Optional) update the CITATION.cff file, if you want to be included in
  the citable contributor list