documenting internal link philosophy