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.

Sign up for GitHub

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

Jump to bottom

New Persian Translation Progress #328

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

New Persian Translation Progress #328

gaearon opened this issue Apr 25, 2023 · 94 comments

Comments

@gaearon
Copy link
Member

gaearon commented Apr 25, 2023 •
edited by rezvani2647

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 gaearon mentioned this issue Apr 25, 2023
Closed
87 tasks
@gaearon gaearon pinned this issue Apr 25, 2023
@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 •
edited

sJJdGG added a commit to sJJdGG/translations.react.dev that referenced this issue Apr 25, 2023
@sJJdGG
Update fa maintainers
0f2cc80 
As discussed in reactjs/fa.react.dev#328
link: reactjs/fa.react.dev#328
title: New Persian Translation Progress
@sJJdGG sJJdGG mentioned this issue Apr 25, 2023
Merged
gaearon pushed a commit to reactjs/translations.react.dev that referenced this issue Apr 25, 2023
@sJJdGG
Update fa maintainers (#273)
f7b7bcb 
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 •
edited

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

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
@sJJdGG @moshfiqrony
Update fa maintainers (reactjs#273)
d362d31 
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
@moshfiqrony @gaearon
@tdd @deblasis @sJJdGG @tesseralis @bvaughn @abolfazlchaman @hph
Add Bengali language for react docs (#266)
e76c125 
* 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 <tesseralis@gmail.com>
Co-authored-by: Brian Vaughn <brian.david.vaughn@gmail.com>

* Add a local create-translation workflow

---------

Co-authored-by: Nat Alison <tesseralis@gmail.com>
Co-authored-by: Brian Vaughn <brian.david.vaughn@gmail.com>

* 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 <dan.abramov@me.com>
Co-authored-by: Christophe Porteneuve <tdd@tddsworld.com>
Co-authored-by: Alessandro De Blasis <alex@deblasis.net>
Co-authored-by: Dan Abramov <dan.abramov@gmail.com>
Co-authored-by: Sajjad Khodadadi <sajjad.khddd@gmail.com>
Co-authored-by: Nat Alison <tesseralis@gmail.com>
Co-authored-by: Brian Vaughn <brian.david.vaughn@gmail.com>
Co-authored-by: Abolfazl Chaman <88617114+abolfazlchaman@users.noreply.github.com>
Co-authored-by: Haukur Páll Hallvarðsson <hph@hph.is>
@faeghe-hajiabadi
Copy link
Collaborator

faeghe-hajiabadi commented Jun 6, 2023 •
edited

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

I can translate these pages?
Your First Component

@faeghe-hajiabadi
Copy link
Collaborator

faeghe-hajiabadi commented Jul 12, 2023 •
edited

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

@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 :)

@Jam-Hejrati
Copy link
Contributor

Hi @rezvani2647
The page "Editor Setup" translated & I made a pull request
Sincerely.

@sr-ssh
Copy link
Contributor

sr-ssh commented Sep 29, 2023

Hi @faeghe-hajiabadi , @rezvani2647 . Thanks for the merge on my last branch. Can you assing me the Conditional Rendering part as well.

@rezvani2647
Copy link
Member

Hi @faeghe-hajiabadi , @rezvani2647 . Thanks for the merge on my last branch. Can you assing me the Conditional Rendering part as well.

it's assigned to you, good luck.

@behrouz-shafaati
Copy link
Contributor

behrouz-shafaati commented Sep 30, 2023 •
edited

Hi @faeghe-hajiabadi , @rezvani2647 . can i translate 'Queueing a Series of State Updates' page? Thanks!

@rezvani2647
Copy link
Member

Hi @faeghe-hajiabadi , @rezvani2647 . can i translate 'Queueing a Series of State Updates' page? Thanks!

it's assigned to you, good luck.

@faeghe-hajiabadi
Copy link
Collaborator

here is a simple wiki page in Farsi for everyone to learn about how to avoid errors. please read it before raising PR. Thanks

@behrouz-shafaati
Copy link
Contributor

Hi @faeghe-hajiabadi, @rezvani2647. I have finished the translation of 'Queueing a Series of State Updates' and have set the PL (Pull Request) for it. Please check it. Now, I would like to translate 'Passing Data Deeply with Context' if it's possible. Thanks :)

@faeghe-hajiabadi
Copy link
Collaborator

Hi @faeghe-hajiabadi, @rezvani2647. I have finished the translation of 'Queueing a Series of State Updates' and have set the PL (Pull Request) for it. Please check it. Now, I would like to translate 'Passing Data Deeply with Context' if it's possible. Thanks :)

I have reviewed the PR, I guess some parts are not clear. can you please send us the screenshot of the working localhost with no errors? Passing Data Deeply with Context is assigned to you.

@ami87878
Copy link

hi, i so excited to find this repo and to help to translate document of React to Persian i for first time i want translate Writing Markup with JSX page if no one has been chosen it

@nafasebra
Copy link
Contributor

Hello, I have worked on the 'your-first-component' page and have fully translated it.
Please review this pull request (PR #385)
@faeghe-hajiabadi @rezvani2647

@rezvani2647
Copy link
Member

rezvani2647 commented Dec 13, 2023 via email

@nafasebra
Copy link
Contributor

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

@nikch97
Copy link

nikch97 commented Dec 16, 2023

@rezvani2647
Hi there. could you please merge PR #382 as well?
Thank you

@Atefeh-Masoumi
Copy link

Hi Can I translate Keeping Components Pure page?

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

@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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests