expanded comments on template

Hopefully this is a positive contribution and I'm not misunderstanding something. I tried to rewrite the comments for a more naive (e.g. me) audience.