Add some details to our dev docs on templating

Start a place where we can document the common pitfals of the golang templates we have been running into, and how to work around them.

[ci skip]