Pe 3832/reviewing updating puppet gat documentation

Incorporating a few notes that I've collected on using the tools.