improve documentation
Merge pull request #1 from Fragan/update_documentation

[master] improve documentation