Error on broken links in the docs

[dstansby]

This errors on any broken links in the documentation, which currently is quite a lot! It will take a while to fix all these, but I think it's worth having this PR open in draft so we can see how we're doing.