User blog comment:Kirkburn/The expanding world of the VisualEditor/@comment-15255052-20141020064427/@comment-126761-20141022185422

After a quick chat with team, we have a suggestion for another way to write it to help avoid this issue:


 * description=

This will actually show up within the template editor, as well as in the article source code. While there is a risk the editor will replace the comment, it at least gets it front and centre while they're making the edit. It will also always be kept in the 'right' location.

I hope this helps!