Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New Persian Translation Progress #328

Open
gaearon opened this issue Apr 25, 2023 · 107 comments
Open

New Persian Translation Progress #328

gaearon opened this issue Apr 25, 2023 · 107 comments

Comments

@gaearon
Copy link
Member

gaearon commented Apr 25, 2023

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
@gaearon
Copy link
Member Author

gaearon commented 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
Copy link
Member

sJJdGG commented 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
Copy link
Member Author

gaearon commented 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
Copy link
Collaborator

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

@rezvani2647
Copy link
Member

rezvani2647 commented Apr 25, 2023 via email

sJJdGG added a commit to sJJdGG/translations.react.dev that referenced this issue Apr 25, 2023
As discussed in reactjs/fa.react.dev#328
link: reactjs/fa.react.dev#328
title: New Persian Translation Progress
gaearon pushed a commit to reactjs/translations.react.dev that referenced this issue Apr 25, 2023
As discussed in reactjs/fa.react.dev#328
link: reactjs/fa.react.dev#328
title: New Persian Translation Progress
@abolfazlchaman
Copy link

abolfazlchaman commented 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
Copy link

mohammad-hosein-shahpouri commented Apr 28, 2023

Hi, I would like to translate "Installation" page

@sJJdGG
Copy link
Member

sJJdGG commented 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.

moshfiqrony pushed a commit to moshfiqrony/translations.react.dev that referenced this issue Apr 29, 2023
As discussed in reactjs/fa.react.dev#328
link: reactjs/fa.react.dev#328
title: New Persian Translation Progress
gaearon added a commit to reactjs/translations.react.dev that referenced this issue Apr 29, 2023
* Add Bangla translation for react docs

I have been working as a software engineer for last 6 years. I have started using React since my first project in my organization.

I have added two more maintainer and both have 3+ years of working experience in React. One of them is currently a Lecture at International university of business agriculture and technology.

We are based at Bangladesh and we want to create a Bangla version of React docs for the better understanding of the Bangla native language people.

* Added the nomandhoni-cs as maintainer

* Added shakib609 and ahnafyy as maintainer

* Added nutboltu as maintainer

* Update pl.json (#272)

* First-pass update to the FR maintainers (#271)

We're in the process of waking up the legacy crew, that had 10+ people contributing significantly (and many more doing small contributions). This is who we can expect lots of work from on the new docs so far.

* Update PROGRESS.template.md

* Update it.json

* Update ar.json to match repo settings

* Update fa.json to match repo settings

* Remove language that was never deployed

* Update he.json to match repo settings

* Update uk.json to match repo settings

* Update vi.json to match the repo settings

* Update zh-hans.json to match repo settings

* Update zh-hant.json to match repo settings

* Stop spamming comments

* Delete CODEOWNERS

* Remove test files

* Move stuff around

* Update fa maintainers (#273)

As discussed in reactjs/fa.react.dev#328
link: reactjs/fa.react.dev#328
title: New Persian Translation Progress

* Update zh-hant.json to match the current list

According to reactjs/zh-hant.react.dev#260 (comment).

* Simplify the translation infra (#285)

* Simplify translation infra

Co-authored-by: Nat Alison <[email protected]>
Co-authored-by: Brian Vaughn <[email protected]>

* Add a local create-translation workflow

---------

Co-authored-by: Nat Alison <[email protected]>
Co-authored-by: Brian Vaughn <[email protected]>

* Tweak wording

* Add fi, lo, and sw translations (#286)

* Update engines

* Allow manually running workflows

* Try to run stuff

* Cursor is now a pointer when mouse is on sort options (#284)

Hi, this minor change helps UX. when the mouse is on the sort options, it visually hints the user what their mouse pointing at is a functional filtering option

* Add Icelandic (#270)

* Oops

* Don't fail on existing sync PRs

* Removed bn.json file

* Added Bengali translation entry

* Update langs.json

---------

Co-authored-by: dan <[email protected]>
Co-authored-by: Christophe Porteneuve <[email protected]>
Co-authored-by: Alessandro De Blasis <[email protected]>
Co-authored-by: Dan Abramov <[email protected]>
Co-authored-by: Sajjad Khodadadi <[email protected]>
Co-authored-by: Nat Alison <[email protected]>
Co-authored-by: Brian Vaughn <[email protected]>
Co-authored-by: Abolfazl Chaman <[email protected]>
Co-authored-by: Haukur Páll Hallvarðsson <[email protected]>
@faeghe-hajiabadi
Copy link
Collaborator

faeghe-hajiabadi commented Jun 6, 2023

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

@amin-da
Copy link

amin-da commented Jun 9, 2023

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

@nafasebra
Copy link
Contributor

Hello @gaearon
I am interested in becoming one of the maintainers of the fa.react.dev
Is it possible?

@faeghe-hajiabadi
Copy link
Collaborator

And i want translate bellow pages:
1- Quick Start
2- Tutorial: Tic Tac Toe
3 -Thinking in React

please check the list of ongoing pages in farsi repo. most of these are in progress. so you need to choose different pages

@nafasebra
Copy link
Contributor

And i want translate bellow pages:
1- Quick Start
2- Tutorial: Tic Tac Toe
3 -Thinking in React

please check the list of ongoing pages in farsi repo. most of these are in progress. so you need to choose different pages

Isn't the list here?
So please send me the current check list for me.

@nafasebra
Copy link
Contributor

nafasebra commented Jul 10, 2023

I can translate these pages?
Your First Component

@faeghe-hajiabadi
Copy link
Collaborator

faeghe-hajiabadi commented Jul 12, 2023

I can translate these pages? Your First Component

https://github.com/reactjs/fa.react.dev > بخش راهنمای مشارکت کنندگان

@rezvani2647 please help on this matter, for new joiners

@rezvani2647
Copy link
Member

I can translate these pages? Your First Component

@nafasebra sounds good, and thanks!

@rezvani2647
Copy link
Member

rezvani2647 commented Jul 12, 2023

@mohammad-hosein-shahpouri "installation" was assigned to you.

@rezvani2647
Copy link
Member

@faeghe-hajiabadi "Thinking in React " was assigned to you.

@rezvani2647
Copy link
Member

@amin-da "Describing the UI" was assigned to you.

@faeghe-hajiabadi
Copy link
Collaborator

@faeghe-hajiabadi "Thinking in React " was assigned to you.

please review my first pr : #342 for thinking in react, almost half is done

@rezvani2647
Copy link
Member

@faeghe-hajiabadi "Thinking in React " was assigned to you.

please review my first pr : #342 for thinking in react, almost half is done

it was great!.
and it needs some improvements. so I wrote some comments for you. :)

@rezvani2647
Copy link
Member

دوستانی که میخوان برای اولین بار ترجمه صفحات رو انجام بدن.
لطفا حتما بخش واژه‌نامه و بخش بحث در مورد واژه‌نامه را مطالعه کنند.
مرسی از لطف همتون

@sr-ssh
Copy link
Contributor

sr-ssh commented Jul 30, 2023

Hi @rezvani2647
I would like to participate in translating Responding to Events .
thanks :)

@minajalili
Copy link

@rezvani2647
Hello, I would like to translate the page titled 'Scaling Up with Reducer and Context'. Is that possible?

@faeghe-hajiabadi
Copy link
Collaborator

@rezvani2647 Hello, I would like to translate the page titled 'Scaling Up with Reducer and Context'. Is that possible?

it is assigned to you, good luck!

@faeghe-hajiabadi
Copy link
Collaborator

Hi Can I translate Keeping Components Pure page?

assigned to you, good luck!

@faeghe-hajiabadi
Copy link
Collaborator

Hello, thanks for merging my PR. Can i translate 'Importing and Exporting Components' page?

assigned to you. good luck!

@Atefeh-Masoumi
Copy link

Hello I would like to translate useReducer in API Reference section

@nafasebra
Copy link
Contributor

Hi,
I have translated the ‘importing-and-exporting-components’ page. Could you please review this pull request (PR #391)?
@faeghe-hajiabadi @rezvani2647

@sr-ssh
Copy link
Contributor

sr-ssh commented Jan 6, 2024

Hi,
I have translated the conditional rendering page. Could you please review this pull request (PR #392) and assign me Escape Hatches page?
thanks
@faeghe-hajiabadi @rezvani2647

@rezvani2647
Copy link
Member

Hello I would like to translate useReducer in API Reference section

Assigned to you. Good luck!

@Abolfazl2647
Copy link
Collaborator

Hi, I want to translate 'Queueing a Series of State Updates.' Thanks!

Your PR about "Queueing a Series of State Updates" has been merged.
Thank your for your time.

@Abolfazl2647
Copy link
Collaborator

@nafasebra
Your PR "importing-and-exporting-components" has been merged.
Thank your for your time.

@Atefeh-Masoumi
Copy link

Atefeh-Masoumi commented Feb 18, 2024

@Abolfazl2647 @faeghe-hajiabadi could you please review and merge my pull request for Translate: translate 'Keeping Components Pure' page to Farsi. #388?

@minajalili
Copy link

Hi, I have worked on the 'scaling-up-with-reducer-and-context' page and have fully translated it.
Please review this pull request (PR #390)
@faeghe-hajiabadi @rezvani2647

@rezvani2647
Copy link
Member

@sr-ssh
Your PR "translated the conditional rendering" has been merged.
Thank your for your time.

@sr-ssh
Copy link
Contributor

sr-ssh commented Feb 19, 2024

Hi,
Would you please assign me Escape Hatches page?
thanks
@faeghe-hajiabadi @rezvani2647

@Mahdi-Hazrati
Copy link

Hello! As a new translator for React, I’d like to contribute by translating the Tutorial: Tic-Tac-Toe page on the React website. Could you please assign this task to me? Thank you! 😊

@Mahdi-Hazrati
Copy link

Hello! As a new translator for React, I’d like to contribute by translating the Tutorial: Tic-Tac-Toe page on the React website. Could you please assign this task to me? Thank you! 😊

@gaearon

@ablfaxl
Copy link

ablfaxl commented May 14, 2024

Hello! As new translator for React, i'd want to contribute by translating the " Start a New React Project" page on React Web.
Could you please assing this task to me ? Thanks 🙏
@rezvani2647 @gaearon

@rezvani2647
Copy link
Member

Hi, Would you please assign me Escape Hatches page? thanks @faeghe-hajiabadi @rezvani2647

Please be more specific.

@rezvani2647
Copy link
Member

Hello! As a new translator for React, I’d like to contribute by translating the Tutorial: Tic-Tac-Toe page on the React website. Could you please assign this task to me? Thank you! 😊

it's assigned to you, good luck.

@rezvani2647
Copy link
Member

Hello! As new translator for React, i'd want to contribute by translating the " Start a New React Project" page on React Web. Could you please assing this task to me ? Thanks 🙏 @rezvani2647 @gaearon

it's assigned to you, good luck.

@abolfazlchaman
Copy link

abolfazlchaman commented May 21, 2024

Hello Mr. @rezvani2647
As i have previously talked with Mr. @sJJdGG about becoming a co-maintainer of this repo and part time translator and pr reviewer in private,

i would like to discuss things further with you sir.
Could you please provide me with a Telegram or WhatsApp handle sir?

Many thanks,
-Abolfazl chaman

@mrbadri
Copy link

mrbadri commented Jul 4, 2024

Hi,

Could you please add the React Reference Overview to your TODO list in the API Reference section?

Thanks!

@mrbadri
Copy link

mrbadri commented Jul 4, 2024

Hi @gaearon,

I would like to translate the "React: Hooks" page. Please consider this request.

Best regards.

@mrbadri
Copy link

mrbadri commented Jul 4, 2024

Hi @rezvani2647 and @gaearon,

I have translated the Hooks page to Persian and have created a Pull Request for it. You can review it here: #423

Looking forward to your feedback!

Thanks,
Mohammad Reza

@ablfaxl
Copy link

ablfaxl commented Jul 6, 2024

Dear @rezvani2647,

I have translated the “Start a New React Project” article into Persian and have submitted a Pull Request for your review. You can find it here: #415.

I would greatly appreciate your feedback on the translation.

Thank you for your time and consideration.

Best regards,
Abolfazl Taghavi

@AliMohammad-Esmaeeli
Copy link

AliMohammad-Esmaeeli commented Nov 14, 2024

Hello dear @rezvani2647 and @gaearon
I want to translate page Fragment,
Is it possible? If yes could you add me to list?
whenever you tell me I will start.

Best regards,
Ali Mohammad

@Majid-Kia
Copy link

Hi dear @gaearon and @rezvani2647
I would like to contribute by translating the "Referencing Values with Refs" page. Could you please assign it to me?

Thank you!

@Mohabatullah0164
Copy link

Mohabatullah Omarzai

@Mohabatullah0164
Copy link

[email protected]

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

No branches or pull requests