fix broken links founds by html-proofer (first pass)

- fix broken links and references found by html-proofer
- set relfileprefix and outfileprefix attributes to fix interdocument xrefs