update templating guide documentation
update according to comments
adjust after feedback from mvriel
Merge pull request #728 from dbu/template-doc-updates

update templating guide documentation