Skip to content

New Persian Translation Progress #328

Description

@gaearon

Maintainers

For New Translators

To translate a page:

  1. Check that no one else has claimed your page in the checklist and comments below.
  2. Comment below with the name of the page you would like to translate. Please take only one page at a time.
  3. 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:

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

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>
  • 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

  1. pinned this issue on Apr 25, 2023
  2. gaearon commented on Apr 25, 2023

    @gaearon
    MemberAuthor

    @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!

  3. sJJdGG commented on Apr 25, 2023

    @sJJdGG
    Contributor

    @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.

  4. gaearon commented on Apr 25, 2023

    @gaearon
    MemberAuthor

    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.

  5. sorousht commented on Apr 25, 2023

    @sorousht
    Contributor

    Hi @gaearon, unfortunately I can't maintain the translation project. If I find time in future, I pick it up again.

  6. rezvani2647 commented on Apr 25, 2023

    @rezvani2647
    Contributor
  7. added a commit that references this issue on Apr 25, 2023
  8. added a commit that references this issue on Apr 25, 2023
  9. abolfazlchaman commented on Apr 27, 2023

    @abolfazlchaman

    Hi, hope you are well @gaearon how can I become a maintainer for this project?

    I could definetly help translate as well if needed.

  10. mohammad-hosein-shahpouri commented on Apr 28, 2023

    @mohammad-hosein-shahpouri

    Hi, I would like to translate "Installation" page

  11. sJJdGG commented on Apr 28, 2023

    @sJJdGG
    Contributor

    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.

  12. added a commit that references this issue on Apr 29, 2023
  13. anna-abadi commented on Jun 6, 2023

    @anna-abadi
    Collaborator

    Hi @gaearon Dan, I would like to help on this page: 'Thinking in React'. Thanks

  14. amin-da commented on Jun 9, 2023

    @amin-da

    Hi @gaearon
    Hi @sJJdGG
    I would like to translate " Describing the UI" page
    Thanks.

  15. 96 remaining items

  16. erfan-esmkhan commented on Dec 4, 2024

    @erfan-esmkhan

    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

  17. AliMohammad-Esmaeeli commented on Dec 10, 2024

    @AliMohammad-Esmaeeli

    Hello agian👋,
    I have translated the Fragment page.
    Could you please review this pull request (PR #442)? :)

    @gaearon @rezvani2647 @faeghe-hajiabadi

    Screenshot 2024-12-10 153238

  18. srbmm commented on Dec 28, 2024

    @srbmm
    Contributor

    Hello dear @rezvani2647 and @gaearon,
    I would like to contribute by translating "Rendering Lists" page.

  19. srbmm commented on Dec 28, 2024

    @srbmm
    Contributor

    Dear @rezvani2647 and @gaearon
    I finish rendering lists page.
    you can review it here: #445

    Thanks,
    Mohammad Sohrabi

  20. KianoshArian commented on Apr 26, 2025

    @KianoshArian
    Contributor

    Hi dear @rezvani2647 and @gaearon
    I would like to translate the "Updating Arrays in State" page.
    Many thanks

  21. mrbadri commented on May 13, 2025

    @mrbadri
    Collaborator

    We are actively trying to revive the fa.react.dev repository in this issue.
    Join us and show your support: reactjs/react.dev#7786

  22. arashMqs commented on May 26, 2025

    @arashMqs
    Contributor

    Hi dear @rezvani2647 and @gaearon
    i am interested to translate the "React Developer Tools" page.

  23. mrbadri commented on Aug 19, 2025

    @mrbadri
    Collaborator

    Hi dear @rezvani2647 and @gaearon i am interested to translate the "React Developer Tools" page.

    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!

  24. YasinDehfuli commented on Oct 1, 2025

    @YasinDehfuli

    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 🙏

  25. nazari2079 commented on Nov 9, 2025

    @nazari2079

    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!

  26. mahdyaralipor commented on Oct 4, 2026

    @mahdyaralipor

    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!

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions