Fix docs

[josiahcarlson]

Right now the docs are supposed to be in restructured text format, but some of the quotes are using markdown-style escapes. That doesn't work and looks ugly.

Also need to fix some typos / grammar mistakes in the docs.

[josiahcarlson]

Bah, fixed the quotes while I was updating the docs on "how it works" (we're using the system profiler now). Will fix the grammar and spelling later, if it matters :P