Fix doc build (warning) errors
Sphinx in 1.6.6 fixed a regression that would allow doc build warnings to
pass unnoticed1. Thus having updated Sphinx would have broken one's
Pulp docs build.
This patch addresses the doc build warnings as well as fixes a broken link
here and there.