Make bullets be formatted properly

[rmglennon]

There needs to be a blank line between the heading and the bullet list items underneath. GitHub-flavored markdown is able to render this properly, but not the parser used in the documentation.

Also, changing the e.g. to "for example"