Mojo::Template suggested update to documentation

[alabamapaul]

Adding section about Comments to inform the developer of potential pitfalls of tags within comments.

[kraih]

I wouldn't mind some clarification around the tokenizer situation, we've actually just talked about it on the IRC channel.
But i don't think this is the right way, since it affects all tags.

[alabamapaul]

I am not certain how this affects all tags since it is a change to POD only.

Perhaps someone who has a better understanding of where documentation such as this should go could take a few minutes of their time to address this, or provide a suggestion as to where (within the documentation) something such as this should be mentioned, and I will gladly draft patches in the appropriate location.

I was concerned because I went from having a functioning Mojolicious application before upgrading to 2.0, to having an application that caused Exceptions after upgrading to 2.0, and wanted to provide documentation for others who may experience a similar situation.

For now, I guess others are at the mercy of finding this information using a search engine rather than within the documentation.

[kraih]

I meant that the explanation itself should be something less specific, perhaps a line somewhere about the nesting of tags. (as you said on the list)