DOC-1281: edits to gems and puppetserver_vs_passenger

Edits in response to feedback.