Merge branch 'hotfix/1127'

Close #1127
Added more comprehensive basic usage information
Merge pull request #1141 from Spabby/master

Added more comprehensive basic usage information
[#1141] Flow line as a paragraph

- Flowed the line into multiple lines; makes it readable on github, and simpler
  to identify diffs in the future.
- Added blank lines after headings
Merge branch 'hotfix/1141' into develop

Forward port #1141