Docs: Indicate links in foreign language

[hannahiss]

Description

Add a lang attribute to links in another language than English

Motivation & Context

For accessibility, we have to indicate the links are in a foreign language (not only the target of the link)

Type of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Refactoring (non-breaking change)
• Breaking change (fix or feature that would change existing functionality)

Checklist

• I have read the contributing guidelines
• My code follows the code style of the project (using npm run lint)
• My change introduces changes to the documentation
• I have updated the documentation accordingly
• I have added tests to cover my changes
• All new and existing tests passed

Live previews

• https://deploy-preview-40767--twbs-bootstrap.netlify.app/docs/5.3/about/translations/

Related issues

[julien-deramond]

LGTM! Good catch, @hannahiss

The links often include an English part in parentheses, as in 'Bootstrap 5 日本語リファレンス (Japanese)', with 'Japanese' being an English word. However, I think that your modification would likely enhance pronunciation for screen readers in the end, even though in this case, 'Japanese' would also be pronounced in Japanese.

I'm handing this PR over to @patrickhlauke for a double-check and feedback, as it's about accessibility.

[hannahiss]

The links often include an English part in parentheses, as in 'Bootstrap 5 日本語リファレンス (Japanese)', with 'Japanese' being an English word.

Yes, I thought about it, but while respecting accessibility, common words can be in another language. Fro example, in a French sentence, you can have "smartphone", "business" or "French", without indicating they are English words. I think "Japanese" will be understood by Japanese speakers.

Anyway, I am curious to have Patrick's opinion on this 😃

[patrickhlauke]

sure, why not :)