Clarify Hiera pseudo-variable scope.

Some customers have been confused about the scope of the hiera
pseudo-varaibles. There has been a redmine, zendesk, and jira ticket
about it, to date.

This clarifies that point.