Collection of fixes and improvements

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | no
| Applies to    | all
| Fixed tickets | -

This PR fixes all kind of typos, formatting and code issues.
It also adds some missing code blocks and notes or improvements.

Thanks for your review and please let me know if you see something wrong.