Improve git_pillar docs

Also fixed a couple sphinx build errors.

Resolves #6689.