Add documentation

[ahuca]

Figure out some auto doc generator for the API based on, for example, comments, or pragmas written inside the source code

[ahuca]

Note well to balance the act and not overcrowd the source files with markup/pragmas/metadata just for the sake of documentation. Proper naming can be a powerful and natural way of documenting the code at source as Uncle Bob and many revered software engineers have said.