Improve readme.markdown
Merge branch 'feature/documentation-work' into develop