improve style and intro text
improve documentation