Clean up sphinx syntax

Plus upgrade http markup package, minor link changes, update intro.

This fixes some indenting problems and some query parameter markup. I also found that the newest version of the ``httpdomain`` package added support for documenting request headers properly, so I added that and converted some of the header mentions into formatted docs.