dijit._Templated documentation could describe limitations better

[jhartikainen]

I was trying to locate information on dijit._Templated's limitations, primarily whether it was designed to support having multiple root-level nodes in the template or not.

I skimmed over the docs at DojoCampus?, but was unable to find anything. However, it was later pointed out on the IRC channel that the page for dijit._Templated said that templates can only have a single root node.

I would suggest the documentation for dijit._Templated be improved by including a list of main points the programmer should know of - such as "only one root level node" - perhaps in the form of a bullet point list. This will make skimming the documentation much easier, and will make finding relevant information faster.

[bill]

Hmm, I'm not sure that qualifies as "main point" more than anything else on ​that page, and I note that "single root node" is the first sentence in the section on templates... but I'lI add a "common pitfalls" section at the end, hopefully that will help some folks.