This fixes a bunch of Sphinx warnings

Not all warnings yet but should correct a number of broken links etc. 
It seems useful, but I don't know where to fit it in.   We should probably have a 'git magic' page for useful git incantations that we use semi-regularly (such as cherry-picking directions).