Spelling fixes and PEP-8/PEP-257 changes

Hi there, I'm not sure what you think about the PEP - http://www.python.org/dev/peps/pep-0008/#documentation-strings and http://www.python.org/dev/peps/pep-0257/ but I do like the standard way - i.e """This docstring style""".

As for the typos, what I see in the salt-api docs site really annoys me, so I fixed that.

Thanks.