#324 minor improvements to template documentation