Fixed invalid nesting
Reoutlined the standards
comply to dir structure standards
tried fixing code block rendering
minor #3986 Rebased #3982 - Some minor fixes (WouterJ)

This PR was merged into the 2.3 branch.

Discussion
----------

Rebased #3982 - Some minor fixes

| Q   | A
| --- | ---
| Doc fix? | yes
| New docs? | no
| Applies to | all
| Fixed tickets | -

Replaces #3982

Commits
-------

be09679 tried fixing code block rendering
f43fa0d comply to dir structure standards
0cd3d89 Reoutlined the standards
3cbf4d9 Fixed invalid nesting