[Feature Request]: Official Farsi (Persian / فارسی) Localization for ZCode Docs & UI (Community Lead Volunteer Ready)
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 22
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
Proposal Overview
Add official Farsi (Persian / فارسی) localization support for the ZCode documentation and desktop application, backed by community volunteer leadership.
Motivation & Community Impact
- Target Audience: Over 100M+ native speakers with an active, fast-growing developer community in Iran and globally, currently underserved with modern AI coding documentation in their native language.
- Current Docs Limitation: The official documentation currently supports English (
EN) and Chinese (ZH) only.
Suggested Phased Implementation
- Phase 1 (Documentation):
- Introduce Farsi language switcher (
fa-IR) on the docs platform. - Establish community localization pipeline (e.g. Crowdin, Weblate, or GitHub pull-request based Markdown translation).
- Introduce Farsi language switcher (
- Phase 2 (Desktop UI Localization):
- Support RTL (Right-to-Left) rendering and Farsi string catalogs (
i18n) in the ZCode desktop client.
- Support RTL (Right-to-Left) rendering and Farsi string catalogs (
Community Volunteer Contribution
Community member Danial [PPLX] (experienced in open-source localization, currently leading Penpot frontend Farsi translation on Weblate) has volunteered to:
- Act as lead Farsi translator and proofreader.
- Help configure community translation tooling (Weblate/Crowdin).
- Coordinate and review community translation PRs.
Origin & Discord Reference
- Author:
Danial [PPLX] - Discord Thread: https://discord.com/channels/1346756824233148527/1549413148426240150
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No files, tests, or code entry points are identified. Start by locating the documentation language switcher and the desktop client's i18n and rendering configuration, then determine the scope of the phased work. Done would include an agreed Farsi documentation workflow and a defined plan for RTL desktop UI support.
Written by the indexing model from the issue text.
Assessment
- Domain
- desktop, documentation, internationalization, localization
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100