Prepare the code for the future contributors

[jakub-zwolakowski]

• solve the current problem with OCamlDoc generation
• reformat existing OCamlDoc
• add basic OCamlDoc description to every module
• document the most important modules in a more detailed way