Clarification in release notes of location of translator comments

[wim@…]

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).

[Tim Graham <timograham@…>]

In f513764e72faf6bd4be1f063d2842cd4e5d76f7d:

Fixed #20515 - Clarified note regarding translator comments.

Thanks wim@ for the suggestion.