Document how the pillar namespace is flattened.
Merge pull request #6343 from go8ose/note-pillar-flat

Document how the pillar namespace is flattened.