Improved i18n support

[chalin]

Tasks

• [i18n] Docs section weights need to be adjusted to work with all languages #4572
• [zh] Strip away embedded HTML en fragments #4602
• [i18n] Add language codes #4622
• [i18n] Support non-English banners with English fallback #4486
• [i18n & ja] Improved fallback config and normalize en doc links #4627
• [CI] i18n GH action check doesn't always work #4641
  • [CI & i18n] i18n script and doc improvements #4648
• [i18n] Propose way to associate translations to specific commit of default lang page #4582
• [i18n] Ensure that fallback pages have en lang attribute #4664
• [i18n][design] Interpret absolute paths as locale specific #4688
• [i18n] localization of snippets inside shortcodes #4783
• Add i18n guidance re. images & shortcodes + some rework #4790
  • [i18n] Ensure section-local image paths fall back to default lang image #4761
• [i18n] Consistently implement the handling of the OTel specs across localizations, and document the solution #4876
  • [i18n] Improve specs redirects #4895
• [i18n] Better address the auto-update of versions across localizations #4825
• Incomplete translations of Chinese documentation #4893
• [i18n] Google translate button in fallback pages for all locales #6117
• Introduce and switch to using include shortcode:
  • [i18n/infra] Introduce include feature with fallback #6309
  • [i18n] Make instrumentation-intro shortcode a simple include #6364
  • ...
• Registry:
  • Registry support for i18n #6320
  • Avoid 800+ blank lines in registry JSON file #6318
  • [registry] Generate registry cards only once and share across locales #6326
  • [i18n] Move registry search-form alert into registry page #6336
• Spell-check support
  • [CI] Spell check en pages only #4816
  • [i18n] Spell-check non-en pages other than ja and zh #4981 - add note that languages with cSpell dictionaries should enable spell checking
  • Update scripts/normalize-cspell-front-matter.pl to read the locale-independent word list from .cspell.yml
• [i18n] Support Netlify redirects for non en pages #4629
  • Ensure non-en community pages that are separate mounts or redirects are working
  • Implement the registry as a redirect for non-en languages
• Ensure that search works as expected (a concern raised for other Docsy sites but that might apply here)
• Ensure that pages, like the new https://opentelemetry.io/ja/docs/specs/, do not show up in the languages dropdown of the corresponding English page, or show it as disabled (which might actually be better)
• [CI] Support htmltest config from doc-page front matter #3889
  • [i18n, CI] How to deal with broken links in non-en pages when updating en pages #5448
  • ...
• [i18n] Ensure repo link text is in the right language #4593
• [i18n] keep the consistent order of section names in the left pane in localized docs page #5108
• Consider showing a banner on non-en pages that are out-of-date relative to their corresponding en page. It would be nice to have a link to the en page Git diff.
• [i18n] Ensure non-English languages have i18n entries defined for the feedback form #4781

Note: some of the items above are carry-over items from #4443.

Other, including ja and zh

• [zh] English fallback-page canonical link should refer to en section page #4487
• Create docs-zh-approvers etc #4465
• [zh] faas/_index.md: fix invalid hash #4645
• Reinstate Prettier to run over zh pages too - [CI & i18n] Support page formatting for ja and zh pages #4630
• [zh] Fix misnamed blog section #5514
• Consider splitting up the Hugo config into parts?
• Move images from under content/en/docs/demo/screenshots into static to ensure that they are shared(?)
• Add Persian version of website pages #4990

References

• add styles to indicate existence of doc for each version etcd-io/website#390 - something that we might want to apply here as well

Other/old

• Followups to Hugo docs edits: Clarify languageCode default in multilingual page gohugoio/hugoDocs#2564 and further contributions