[TASK] Remove "common pitfalls" (#387)

Displaying wrong syntax in order to teach someone is generally not considered best practise. Also some of these are specific to sphinx or outdated spinx versions.

Co-authored-by: lina.wolf <[email protected]>