Docs corrected

* Github treads < > as tags which shallows chunks of text annoying but
  workaround is to replace with { } proof-read,
* Spelling-mistakes corrected
* Reformatted some text

Category: maintenance