tweak documentation wording until ~ line 80

I really like the approach of this project, so I started to dive into it. The first thing I would like to contribute are small improvements of the documentation (until line 80 so far).