Add and change comments to be more helpful

Changed according to Jordan's advice on the comments for PR #9.
Also changes the jinja 'safe' filter to 'escape' since that's actually
what we want.