If is often hard for new developers to find out which variables to pass when including eg: the google paginator tempate, or the dadatype/view/ezimage template.

It would be good to add a comment vlock at the top of every template, with a javadoc-style declaration of all variables that are used in the template without being declared there.
Not only it would help new developers, but it could find its way in the online docs of modules and views.

Of course this is a hard and long task, but a script could be developed that takes care of it in an automated way.

Side note: this could be done after converting all let/default statements in templates to def/set ones