fixed a couple of typos

just to clear up a couple-o-things in the docs. also added syntax highlighting via github-flavored-markdown on the code excerpts