- Issue created by @Amber Himes Matz
In
π
Fix up minor copy problems in help topics
Fixed
we are standardizing how links to the Drupal User Guide in the Additional resources of many help topics are worded and displayed. In the process, I noticed how we are inconsistent with how we are wrapping these links with Twig {% trans %}{% endtrans %}
tags, which are used to denote translation strings for localization. You can see the inconsistency here: https://localize.drupal.org/translate/languages/de/translate?project=dru...β¦]49123&search=User%20Guide&author&context=all&limit=10&sid=0
We should decide on a standard -- whether or not to include the anchor tag inside the {% trans %}{% endtrans %}
tags. Then we should update the Help Topics Standard doc's code example with an example. Then we should update the help topics in accordance with the standard. This will affect existing translations, but hopefully won't be a major burden because we're just removing or adding HTML tags inside a translation string.
I'm leaning toward not including HTML anchor tags <a></a>
inside a Twig {% trans %}{% endtrans %}
in a help topic. For example:
<li><a href="https://www.drupal.org/docs/user_guide/en/structure-taxonomy-setup.html">{% trans %}Setting Up a Taxonomy (Drupal User Guide){% endtrans %}</a></li>
But there is at least 1 example outlier, where there is text following the link, and the link text and the following text should be translated in context with each other. For example:
<li>{% trans %}<a href="https://www.drupal.org/docs/user_guide/en/security-chapter.html">Security and Maintenance (Drupal User Guide)</a>, which includes information on how to update your site's core software, modules, and themes.{% endtrans %}</li>
1. Decide on a course of action.
2. Update the Help Topics Standards code example.
3. Update the help topics.
4. Change record for translators.
Active
11.0 π₯
Last updated