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.
Merge pull request #298 from zacharyalexstern/hiera_pseudovariable_scope

Clarify Hiera pseudo-variable scope.