added documentation
fixed some formulations in the documentation
Merge pull request #22 from stage1/feature/doc

First try at documentation