Make the more foolproof comment syntax more prominent

The {{!-- Comment }} syntax can accommodate any kind of comment, including both plain text and commented out code.

However, {{! Comment }} can not (it can break for commented out Handlebars code, or even something that looks like commented out code), so it is likely to confuse.

This puts the more foolproof syntax first, and puts the other one last with a note/warning.