(PDB 686) Add warning about PDB-686 to release notes

This adds a warning about PDB-686 to the release notes so users know how to work-around it.

This also cleans up the linking in our current release notes, and removes the warning about Puppet 3.4.x, because we pin against 3.5.1 and greater anyway.