[FEATURE] Improve C++ code documentation

[petersalemink95]

To make the C++ code easier to understand it would be nice to improve the code documentation.

Tasks:

• Choose 1 style for code documentation and adjust all documentation to this style
• Make sure the functions contain a clear explanation of the logic, the input arguments and the return type
• Write some markdown documentation for developers about philosophical design choices.