improvements and fixes to docs
Merge pull request #2 from domurtag/master

improvements and fixes to docs