It would be useful to have a test that walks through our documentation and fails if any links are broken. There are probably standard ways to do this (some web searching may be the right place to start) but I suspect that a regex through all rst files in the docs/source directory followed by trying them all and looking at status messages would be an ok start.