doc: Add code and API documentation

[weltling]

The public library API needs to be documented for the end consumer. It is thinkable to approach this using code inline documentation and then generate a readable format using tools like doxygen or similar. The exact method on how to implement this is to be evaluated and discussed closer, to achieve the best result.