(DOC-698) Revise doc text for modulepath, environmentpath, and friends
These settings wanted some more clarity about the nature of the deprecation and
the nature of the recommended path forward. I also took the chance to move away
from links.puppetlabs.com for a URL whose permanent address we know today.