Document how the pillar namespace is flattened.

I found it a little confusing how pillar data was presented. Unlike in the sls files, the name of the pillar from the top.sls is not used in data that is presented in the pillars. To make this clearer to new users (like myself) I'm suggesting this documentation change.