Improve initial pillar doc

I think the pillar intro was too light on details. Hopefully this makes
it easier to follow.
Merge pull request #13701 from cachedout/pillar_doc_brushup

Improve initial pillar doc