Clean up sphinx syntax, upgrade http markup package, minor link changes, update intro.
Merge pull request #2689 from metalivedev/fix-syntax

Clean up sphinx syntax