id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
20515	Clarification in release notes of location of translator comments	wim@…	nobody	"Hi all,

I find the following sentences extremely difficult to comprehend. Maybe we can reword them in order to clarify a bit.

Original text:

{{{
Validation of the placement of Comments for translators in templates specified using {# / #} is now stricter. All translator comments not located at the end of their respective lines in a template are ignored and a warning is generated by makemessages when it finds them. E.g.:

{# Translators: This is ignored #}{% trans ""Translate me"" %}
{{ title }}{# Translators: Extracted and associated with 'Welcome' below #}
<h1>{% trans ""Welcome"" %}</h1>
}}}

Proposal:
Translator comments in templates need to be at the end of a line. If not, a warning is generated by makemessages when it finds them in the wrong place. For example, this raises an error.

(Actually, I am not sure about whether I interpreted the text correctly so my text may be plain wrong)."	Cleanup/optimization	closed	Documentation	1.6-alpha-1	Normal	fixed			Unreviewed	0	0	0	0	0	0