Some documentation fixups.

- Repheased some of the things that weren't clear while reading them
- Put javascript hilighting whenever we had JSON
- don't use more that three spaces for code-blocks.
Merge pull request #82 from ametaireau/doc-fixup

Some documentation fixups.