in such templates (ie not view template), we should put a comment at the begin with at least the purpose of the template and a description of the expected variables.