Opened 20 months ago

#6114 new change

Add ability to specify documentation link in translatable strings

Reported by: greiner Assignee:
Priority: P3 Milestone:
Module: User-Interface Keywords:
Cc: wspee, saroyanm, Shikitita Blocked By:
Blocking: Platform: Unknown / Cross platform
Ready: yes Confidential: no
Tester: Unknown Verified working: no
Review URL(s):



Translatable strings can include basic HTML tags such as <a> and <strong> but no arbitrary HTML for security reasons. Anchor tags will be hyperlinked at runtime when we convert those strings into HTML elements.

However, the order of the links may change in certain languages and there's no indication whether that is the case when we decide on which links should be assigned which URL. Furthermore, we have to set the "href" attribute for each link individually.

We could resolve both issues at once by including the documentation link ID directly in the translatable strings. This'll (a) allow us to associate the anchor tag with the correct URL, (b) resolve hyperlinks automatically during the conversion process and (c) further ensure that only documentation links are used.

What to change

Extend support for HTML anchor tags in translatable strings to allow for an optional "doclink" attribute which is expected to contain the associate documentation link ID.


We'd like to encourage websites to use straightforward, unobtrusive advertising. That's why we've established <a doclink="acceptable_ads_criteria">strict guidelines</a> to identify acceptable ads, which are shown under default settings. If you still want to block every ad you can <a>disable</a> this in a few seconds.

Change History (0)

Note: See TracTickets for help on using tickets.