documentation

[RobTillaart]

• work in progress, need to check if notes are still valid.
• contains old commits ==> squash needed