Clarify that our guidance around $:: is different for Hiera

Because Hiera brings in data from the local scope for all lookups, it basically
reproduces the dynamic scope problem from Puppet 2.x. Adding this reminder about
why we recommend using ::varname -- and pointing out that it differs from our
guidance for Puppet -- should help keep things clear.