Fix various documentation issues

- Remove formatting that interferes with code highlighting
- Fix some XML syntax issues
- Added missing punctuation
Merge pull request #429 from VasylTretiakov/master

* pull429:
  Fix various documentation issues