update generator template model, explanations, link to more docs