update templating guide documentation

thanks again for all the explanations last week. i tried to write down what i understood.

i cleaned up the TODO comments with the provided feedback