Repository navigation
docs: add Persian (fa-IR) README - #95
Merged
Merged
Conversation
Persian translation of the root README, placed in .github/readmes/ like every other locale, and registered in the language switcher of all 15 files so the row stays symmetric. Review of the incoming draft before committing: - dropped 308 [span_N](start/end_span) citation markers left by the translator - restored the blank line structure from README.md; the draft had collapsed them to 4 against 127 in the English file, which breaks lists, tables and callouts - fixed the paths for the new location: assets become ../assets/, the repository root documents become ../../, the CONTRIBUTING translations ../contributing/, and the language switcher points at the sibling files with فارسی bolded and English linking back to ../../README.md. Every relative link and image in the file now resolves to a real path - seven lines started with a Latin character, the product name or the language switcher, which made the bidi algorithm lay those paragraphs out left to right inside a Persian document. Each now carries a U+200F RIGHT-TO-LEFT MARK right before the first visible character, after the markdown syntax, so the paragraph direction is RTL. The character is invisible and changes no link or heading - one Arabic yeh inside a Persian word; the yeh and teh marbuta in العربية stay, since that is the native name - terminology aligned with Translations.fa-IR.resx rather than transliterated: Copilot, PowerShell, Reflection, Hibernation, Prefetch, Registry, Task Manager, widgets as ابزارکها, recycle bin as سطل بازیافتنی, scheduled tasks as وظایف زمانبندیشده, and the risk labels the app shows: امن، با احتیاط، تخصصی - سوالات to سؤالات, آپدیت to بهروزرسانی, and the Discord banner alt text dropped the stray digit The switcher change is a single appended entry per file, nothing else in those 14 files was touched. Structure verified against README.md: 33 headings at matching levels, 83 links, the same elements in the same order, and all 15 files resolve to the same 84 distinct targets. One difference worth noting: the GPL badge here points at ../assets/gplv3.png, which resolves. The existing locale files keep .github/assets/gplv3.png, which does not resolve from .github/readmes/, so their licence badge is currently broken. Fixing those is a separate change and not touched here.
itsfatduck
approved these changes
Oct 13, 2026
itsfatduck
left a comment
Owner
There was a problem hiding this comment.
Nice! Thank you for contributing Persian README locale!
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the Persian (fa-IR) README, in the same commit as its registration in the language switcher.
What
.github/readmes/README.fa-IR.md, a translation of the root README**فارسی**appended to the switcher row in all 15 files, so the row stays symmetric: the root README plus every other locale lists this one, and none of them was touched beyond that one appended entryReview of the incoming draft
The draft needed real cleanup before it was usable, so this is not just a copy:
[span_N](start/end_span)citation markers left by the translator, removedREADME.mdline for line./.github/assets/,./CONTRIBUTING.mdand./LICENSEwould all resolve to paths that do not exist from.github/readmes/. Assets are now../assets/, root documents../../, the CONTRIBUTING translations../contributing/, and the switcher points at the sibling files with فارسی bolded and English linking back to../../README.md. Every relative link and image resolves now.Translations.fa-IR.resxrather than transliteration: Copilot, PowerShell, Reflection, Hibernation, Prefetch, Registry, Task Manager, widgets as ابزارکها, recycle bin as سطل بازیافتنی, scheduled tasks as وظایف زمانبندیشده, and the risk labels the app itself shows, امن / با احتیاط / تخصصیVerification
README.md, 83 links, same elements in the same orderWorth noting separately
The GPL badge here points at
../assets/gplv3.png, which resolves. The 13 existing locale files keep.github/assets/gplv3.png, which does not resolve from.github/readmes/, so their licence badge is currently broken in this repository. That is a pre-existing bug and not touched here, since it is unrelated to this contribution.