Doco - if I ever have to touch dozens of files to change one link again,
I'll stab someone - so make sure we don't have to.