extended DocBlocks
readme fixes
removed trailing whitespaces
some more before are bigger rewrite