add some comments to the template for common options

unfortunately, there's no way to propagate these with yaml, but they can be helpful.