Repository navigation
New Persian Translation Progress #328
Description
Maintainers
For New Translators
To translate a page:
- Check that no one else has claimed your page in the checklist and comments below.
- Comment below with the name of the page you would like to translate. Please take only one page at a time.
- Clone this repo, translate your page, and submit a pull request!
Before contributing, read the glossary and style guide (once they exist) to understand how to translate various technical and React-specific terms.
Please be prompt with your translations! If you find that you can't commit anymore, let the maintainers know so they can assign the page to someone else.
For Maintainers
When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:
- Quick Start (@tesseralis) #12345
When PRs are merged, make sure to mark that page as completed!
Main Content
To do before releasing as an "official" translation. Please translate these pages first.
Note that each section has an index page, which needs to be translated too.
Learn React
-
Quick Start (@faeghe-hajiabadi) quick start #377
- Tutorial: Tic Tac Toe (@PouriaDamavandi & @mrbadri) Chore/translate tic tac teo #504
- Thinking in React (@faeghe-hajiabadi) Traslation/fa thinking in react #344
-
Installation (@mrbadri) Chore/translate installation #486
- Create a React App (@mrbadri) Translate creating a react app #488
- Build a React App From Scratch (@mrbadri)
- Add React to an Existing Project (@mrbadri) Translate add react to an existing project #490
-
Setup (@mrbadri) Translate setup #489
- Editor Setup (Abolfazl Rezvani Naraqi)
- Typescript (@mrbadri) Chore/translate learn typescript #498
- React Developer Tools (@arashMqs) translate react-developer-tools page to persian #471
-
React Compiler (@mrbadri)
-
Describing the UI (@amin-da)
- Your First Component (@nafasebra) Translate: translate 'your-first-component' page to Farsi. #385
- Importing and Exporting Components (@nafasebra ) Translate 'importing and exporting components' to Farsi #391
- Writing Markup with JSX
- JavaScript in JSX with Curly Braces
- Passing Props to a Component (@masoudmhmdi )
- Conditional Rendering (@sr-ssh) translation of conditional rendering #392
- Rendering Lists (@srbmm) Translating rendering-lists.md. #445
- Keeping Components Pure (@Atefeh-Masoumi )
-
Adding Interactivity
- Responding to Events (@sr-ssh) #translation of responding to events #346
- State: A Component's Memory (@faeghe-hajiabadi) State a component's memory #350
- Render and Commit
- State as a Snapshot (@faeghe-hajiabadi) Fa/state as snapshot #371
- Queueing a Series of State Updates (@behrouz-shafaati) End of translation "Queueing a Series of State Updates" #367
- Updating Objects in State (@mohammadrezanamjoo)
- Updating Arrays in State (@KianoshArian) translate updating arrays page to persian #467
-
Managing State
- Reacting to Input with State (@nikch97) (Translate reacting to input with state #382)
- Choosing the State Structure (@AlirezaBs)
- Sharing State Between Components (@Ehsan-Yari ) Sharing State Between Components #357
- Preserving and Resetting State (@Hadi-bakhshi )
- Extracting State Logic into a Reducer (@Hadi-bakhshi)
- Passing Data Deeply with Context (@behrouz-shafaati)
- Scaling Up with Reducer and Context (@minajalili )
-
Escape Hatches
- Referencing Values with Refs
- Manipulating the DOM with Refs (@amir-reza-tavakkoli)
- Synchronizing with Effects
- You Might Not Need an Effect
- Lifecycle of Reactive Effects
- Separating Events from Effects
- Removing Effect Dependencies
- Reusing Logic with Custom Hooks
API Reference
-
react: Hooks-
useCallback -
useContext -
useDebugValue -
useDeferredValue -
useEffect -
useId -
useImperativeHandle -
useInsertionEffect -
useLayoutEffect -
useMemo -
useReducer(@Atefeh-Masoumi) -
useRef -
useState -
useSyncExternalStore -
useTransition
-
-
react: Components-
<Fragment> (<>) -
<Profiler> -
<StrictMode> -
<Suspense>
-
-
react: APIs-
createContext -
forwardRef -
lazy -
memo -
startTransition
-
-
react-dom: Components- Common (e.g.
<div>) -
<input> -
<option> -
<progress> -
<select> -
<textarea>
- Common (e.g.
-
react-dom: APIs-
createPortal -
flushSync -
findDOMNode -
hydrate -
render -
unmountComponentAtNode
-
-
react-dom/client: Client APIs-
createRoot -
hydrateRoot
-
-
react-dom/server: Server APIs-
renderToNodeStream -
renderToPipeableStream -
renderToReadableStream -
renderToStaticMarkup -
renderToStaticNodeStream -
renderToString
-
Navigation and UI
We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.
- Homepage (currently in
HomeContent.js) - Sidebars (currently in
src/sidebar*.json) - Top-level navigation (currently in
TopNav.tsx)
When You're Ready...
After everything above is translated, add your language to deployedLanguages in Seo.tsx of the original reactjs/react.dev repository.
Secondary Content
These API pages should ideally be translated too, but they're less urgent and can be done after the others:
- Legacy React APIs
-
Children -
cloneElement -
Component -
createElement -
createFactory -
createRef -
isValidElement -
PureComponent
-
Optional Content
These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:
- Community
- Blog
- Warnings
Activity
gaearon commentedon Apr 25, 2023
@sorousht @zahrajoulaei @sJJdGG @Schabaani @masoud-bahrami @rezvani2647
Could you please confirm whether you'd be able to steer and maintain this translation? I'd like to get the list in https://github.com/reactjs/translations.react.dev/blob/main/langs/fa.json up-to-date. Thank you!
sJJdGG commentedon Apr 25, 2023
@gaearon Hi dan. You can count on me. I'm willing to put 10Hrs/week at least for the next 6 months.
I'd start by closing and merging current PRs and coordianting community effort for the translation of new docs.
If nobody shows up for translations, I'm going to translate new pages myself although it would be slower.
gaearon commentedon Apr 25, 2023
Thanks! If it turns out that other maintainers are not active, please send a PR to https://github.com/reactjs/translations.react.dev/blob/main/langs/fa.json so that the list is up-to-date.
sorousht commentedon Apr 25, 2023
Hi @gaearon, unfortunately I can't maintain the translation project. If I find time in future, I pick it up again.
rezvani2647 commentedon Apr 25, 2023
Update fa maintainers
Update fa maintainers (#273)
abolfazlchaman commentedon Apr 27, 2023
Hi, hope you are well @gaearon how can I become a maintainer for this project?
I could definetly help translate as well if needed.
mohammad-hosein-shahpouri commentedon Apr 28, 2023
Hi, I would like to translate "Installation" page
sJJdGG commentedon Apr 28, 2023
Hi @mohammad-hosein-shahpouri
If you could start the translation and open the related PR, I can assign it to you as mentioned int the manual.
Thanks.
Update fa maintainers (reactjs#273)
Add Bengali language for react docs (#266)
anna-abadi commentedon Jun 6, 2023
Hi @gaearon Dan, I would like to help on this page: 'Thinking in React'. Thanks
amin-da commentedon Jun 9, 2023
Hi @gaearon
Hi @sJJdGG
I would like to translate " Describing the UI" page
Thanks.
96 remaining items
erfan-esmkhan commentedon Dec 4, 2024
Hi dear @gaearon and @rezvani2647
I would like to contribute by translating the "Add React to an Existing Project" page.
Could you please assign it to me?
many Thanks!
Erfan Esmkhani
AliMohammad-Esmaeeli commentedon Dec 10, 2024
Hello agian👋,
I have translated the
Fragmentpage.Could you please review this pull request (PR #442)? :)
@gaearon @rezvani2647 @faeghe-hajiabadi
srbmm commentedon Dec 28, 2024
Hello dear @rezvani2647 and @gaearon,
I would like to contribute by translating "Rendering Lists" page.
srbmm commentedon Dec 28, 2024
Dear @rezvani2647 and @gaearon
I finish rendering lists page.
you can review it here: #445
Thanks,
Mohammad Sohrabi
Update fa maintainers (#273)
Add Bengali language for react docs (#266)
KianoshArian commentedon Apr 26, 2025
Hi dear @rezvani2647 and @gaearon
I would like to translate the "Updating Arrays in State" page.
Many thanks
mrbadri commentedon May 13, 2025
We are actively trying to revive the fa.react.dev repository in this issue.
Join us and show your support: reactjs/react.dev#7786
arashMqs commentedon May 26, 2025
Hi dear @rezvani2647 and @gaearon
i am interested to translate the "React Developer Tools" page.
mrbadri commentedon Aug 19, 2025
Hi @arashMqs,
Thank you for your interest in contributing!
Feel free to go ahead and translate the React Developer Tools page. Once you’ve started, please comment here again or open a draft PR so we can track progress.
Looking forward to your contribution!
YasinDehfuli commentedon Oct 1, 2025
Hi @gaearon,
I’ve noticed that the React DOM, React Hooks, and React Components sections of the React documentation haven’t been translated yet. I’d love to handle the translation of these parts to help make the docs more complete and accessible.
Could you please point me to the right place to start contributing?
Thanks a lot 🙏
nazari2079 commentedon Nov 9, 2025
Hi Dear @gaearon and @mrbadri
I wasn’t aware that I needed to mention my name and specify the page I was translating when creating this pull request. I went ahead and created a PR, translating the 'Describing the UI' page.
If needed, I’m happy to update the PR with the proper format or provide any additional information.
Thanks!
mahdyaralipor commentedon Oct 4, 2026
Hi! I'd like to translate the Writing Markup with JSX page (
src/content/learn/writing-markup-with-jsx.md). Please assign it to me. Thanks!