[WIP] update templating guide documentation

thanks again for all the explanations last week. i tried to write down what i understood.

this PR has still a few TODO in it with open questions. would be great if you can provide some insight on them and i will update the PR to integrate your answers :-)