improved comments
Merge branch 'release-1.0' into develop