few more docs

Hi,

although I might touch this sources again tomorrow, I thought it's good to open a PR in order to receive early feedback (mostly of the cure type, about missing pieces/paragraphs). Yet, any feedback is welcome :)