improved docs
release 1.0
Merge branch 'release/1.0' into develop
next snapshot: 1.1-SNAPSHOT