💡 Add source documentation from recent conversations.

Created by: dawnbreak

There have been some conversations in the last weeks which explained several parts of the code, so add it to the source code documentation for further enlightenment. Also some other small source code documentation improvements.

Maybe someone could check if I understood correctly and add the documentation to the right places.

Fixes #935 (closed) by documenting the behaviour.