Add section about the Sphinx linkcheck output parsing

- Add warning priority table based on the link type/error code
- Add warning thresholds table marking the build as unstable
Add fixes suggested by Helen and improve threshold table
Merge pull request #266 from sbesson/linkcheck_parser

Add section about the Sphinx linkcheck output parsing