#20: improve documentation

Improving the cahnges made with milestone v0.2.0 and parts that were
missing since v0.1.0. But not prooved or corrected in spelling!