This fixes a bunch of Sphinx warnings

Not all warnings yet but should correct a number of broken links etc. 
That link does not point to any thing. Do we have a better link?