Skip to content

feat(fa): translate the accessibility best practices guide - #3753

Open
Parhamfakhar1 wants to merge 1 commit into
github:mainfrom
Parhamfakhar1:feat/fa-accessibility-translation
Open

Parhamfakhar1 wants to merge 1 commit into
github:mainfrom
Parhamfakhar1:feat/fa-accessibility-translation

Conversation

@Parhamfakhar1

@Parhamfakhar1 Parhamfakhar1 commented Sep 21, 2026

Copy link
Copy Markdown
  • Have you followed the contributing guidelines?
  • Have you explained what your changes do, and why they add value to the Guides?

Please note: we will close your PR without comment if you do not check the boxes above and provide ALL requested information.


_articles/accessibility-best-practices-for-your-project.md currently ships in
English, Russian and Simplified Chinese only. The other 26 locales, Persian
included, have no file: every non-English locale ships 12 articles, /en/ ships 13.

This adds the Persian translation: one new file, nothing else touched, same shape
as the merged Russian PR #3742.

  • front matter per docs/translations.md: lang: fa, translated title/description,
    class/order/image unchanged, no untranslated field left behind.
  • every URL is copied from the English file — headings 41/41 and ](http links
    30/30 against it, and a block-by-block comparison shows 98/98 content blocks,
    so no section is missing.
  • technical names (WCAG, ARIA, VoiceOver, axe-core, CI/CD, ACCESSIBILITY.md) are
    left untranslated, the way the rest of the Persian articles handle them.
  • node test/prose reports no issues.

`_articles/accessibility-best-practices-for-your-project.md` exists only in
English, Russian and Simplified Chinese; 25 other languages, Persian among them,
have no file at all, so /fa/ shows 12 guides while /en/ shows 13.

This adds the Persian translation of the whole article: one new file, nothing
else touched, same shape the merged Russian PR used.

* front matter follows docs/translations.md: `lang: fa`, translated
  title/description, `class`/`order`/`image` unchanged, no `untranslated` flag.
* all 30 links and every URL are copied from the English file, so no target
  drifts; headings 41/41 and links 30/30 against the English source.
* technical names (WCAG, ARIA, VoiceOver, axe-core, CI/CD, `ACCESSIBILITY.md`,
  exit codes) are kept untranslated, as the other Persian guides do.
* `node test/prose` reports no issues for this file (the repo's markdown lint is
  green on the tree with this file added).

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant