Minor updates to docs

Some minor updates to the documentations.  Mostly grammatical issues... and a small formatting issue so the numeric list renders with the correct number of items.

@fosdev Please review and let me know if needs any changes.
Thanks very much!