added some helpful documentation comments to the templates