Improve Docs

[FBumann]

Prerequisites

• I have searched existing issues and discussions
• I have checked the documentation

Feature Category

Documentation/Examples

Problem Statement

I think our documentation could be improved.

Proposed Solution

Use Case & Examples

Desired API (Optional)

Alternatives Considered

No response

Priority/Impact

None

Additional Context

No response

[FBumann]

#316 already is a big improvement imo