Add support for extlinks

This commit adds support for extlinks, which has been used to condense BZ links
as well as link to documents in platform. Extlinks is preferred if you need to
link to an entire URL instead of to a specific ref.

Some sphinx build warnings have also been addressed.
I was thinking about that too. I bet readthedocs allows injecting the URL somehow but I need to research it a bit.