less links in  code

-since we have no permalink strategy we cannot guarantee links will
exist for several year
-adding links to doco pages in code means the context of those doco
pages needs to remain consistent forever. ie they cannot evolve in a way
that makes them no longer relevant to the code linking to them

this is simply too much tax moving forward so removing links from the
code