some syntax errors and formatting fixups
Merge pull request #763 from newgoliath/patch-3

+2 docs only