Properly document each public facing API

[SebastianoTaddei]

Not only function docs but also module docs, only when needed (i.e., public facing API)