Add section about the Sphinx linkcheck output parsing (rebased onto develop)



This is the same as gh-266 but rebased onto develop.

----

- Add warning priority table based on the link type/error code
- Add warning thresholds table marking the build as unstable