improvements in docs
Merge branch 'better-docs' into develop