search

reactjs / fa.react.dev

(Work in progress) React documentation website in Persian
https://fa.react.dev
Creative Commons Attribution 4.0 International
189 stars 146 forks source link

New Persian Translation Progress #328

Open gaearon opened 1 year ago

gaearon commented 1 year ago

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

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.

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:

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:

gaearon commented 1 year ago

@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 commented 1 year ago

@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 commented 1 year ago

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 commented 1 year ago

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

rezvani2647 commented 1 year ago

Hi, I love to help and participate but currently I’m busy at the moment and I only have 2 hours a week.

abolfazlchaman commented 1 year ago

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 commented 1 year ago

Hi, I would like to translate "Installation" page

sJJdGG commented 1 year ago

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.

faeghe-hajiabadi commented 1 year ago

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

amin-da commented 1 year ago

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

nafasebra commented 1 year ago

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

faeghe-hajiabadi commented 1 year ago

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 commented 1 year ago

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 commented 1 year ago

I can translate these pages? Your First Component

faeghe-hajiabadi commented 1 year ago

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 commented 1 year ago

I can translate these pages? Your First Component

@nafasebra sounds good, and thanks!

rezvani2647 commented 1 year ago

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

rezvani2647 commented 1 year ago

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

rezvani2647 commented 1 year ago

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

faeghe-hajiabadi commented 1 year ago

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

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

rezvani2647 commented 1 year ago

@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 commented 1 year ago

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

sr-ssh commented 12 months ago

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

rezvani2647 commented 12 months ago

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

it's assigned to you. thank you as well.

sr-ssh commented 11 months ago

Hi @rezvani2647 I have finished the Responding to Events part and it is pended for review. I also want to participate in translating Adding Interactivity part completely. thanks

faeghe-hajiabadi commented 11 months ago

Hi, #346 reviewed, please check the comments. Thank you for your time and effort @sr-ssh

sr-ssh commented 11 months ago

hi @faeghe-hajiabadi I have some more questions in #346 . would you please help .

faeghe-hajiabadi commented 11 months ago

please assign it to me: State: A Component's Memory @rezvani2647

faeghe-hajiabadi commented 11 months ago

please help to review the revised PR for the "thinking in React" page: https://github.com/reactjs/fa.react.dev/pull/344 cc @rezvani2647 @abolfazlchaman

faeghe-hajiabadi commented 11 months ago

hi @faeghe-hajiabadi I have some more questions in #346 . would you please help .

please check this link for any .md file's result in vscode: https://code.visualstudio.com/docs/languages/markdown

rezvani2647 commented 11 months ago

please assign it to me: State: A Component's Memory @rezvani2647

@faeghe-hajiabadi State: A Component's Memory was assigned to you.

rezvani2647 commented 11 months ago

Hi @rezvani2647 I have finished the Responding to Events part and it is pended for review. I also want to participate in translating Adding Interactivity part completely. thanks

@sr-ssh many thanks to you. after I finished reviewing your PR, I will assign that page to you.

nikch97 commented 11 months ago

Hello @gaearon , @rezvani2647 Could you please assign the page ' Reacting to Input with State' to me? Thank you

rezvani2647 commented 10 months ago

@nikch97 yes of course, it's assigned to you.

faeghe-hajiabadi commented 10 months ago

Please assign to me: adding interactivity and also some more pull requests

faeghe-hajiabadi commented 10 months ago

@nikch97 @sr-ssh @nafasebra and all dear devs, please refer to this page to start your translations: how to start?, any questions about how to start and what format is accepted please just drop me an email at: faeghe.hajiabadi@gmail.com or leave a comment on my fork Thank you

AlirezaBs commented 10 months ago

Can I request to translate, or is more experience needed?

rezvani2647 commented 10 months ago

Can I request to translate, or is more experience needed?

by experience you mean a certificate, then i should say no. you do not need any certificates here. but of course your translation will carefully reviewed and it should be correct and fluent.

AlirezaBs commented 10 months ago

Can I request to translate, or is more experience needed?

by experience you mean a certificate, then i should say no. you do not need any certificates here. but of course your translation will carefully reviewed and it should be correct and fluent.

thanks for your answer, can I translate Choosing the State Structure page in adding Interactivity section?

rezvani2647 commented 10 months ago

Can I request to translate, or is more experience needed?

by experience you mean a certificate, then i should say no. you do not need any certificates here. but of course your translation will carefully reviewed and it should be correct and fluent.

thanks for your answer, can I translate Choosing the State Structure page in adding Interactivity section?

it's assign to you, good luck.

Ehsan-Yari commented 10 months ago

Hi @rezvani2647 I would like to participate in translating Sharing State Between Components . thanks <3

nikch97 commented 10 months ago

@nikch97 @sr-ssh @nafasebra and all dear devs, please refer to this page to start your translations: how to start?, any questions about how to start and what format is accepted please just drop me an email at: faeghe.hajiabadi@gmail.com or leave a comment on my fork Thank you

Hello, is there any finished translation in the project that I can see it? I found "thinking-in-react" , but it has error and does not work properly, Could you assist with this? Here is the error that I get on my machine : error

faeghe-hajiabadi commented 10 months ago

@nikch97 @sr-ssh @nafasebra and all dear devs, please refer to this page to start your translations: how to start?, any questions about how to start and what format is accepted please just drop me an email at: faeghe.hajiabadi@gmail.com or leave a comment on my fork Thank you

Hello, is there any finished translation in the project that I can see it? I found "thinking-in-react" , but it has error and does not work properly, Could you assist with this? Here is the error that I get on my machine : error

Thank you. PR NO: 358 raised to fix this issue

faeghe-hajiabadi commented 10 months ago

Hi @rezvani2647 I would like to participate in translating Sharing State Between Components . thanks <3

Assigned to you, please start

mohammadrezanamjoo commented 10 months ago

Hi @rezvani2647 I would like to participate in translating Updating Objects in State . regards

rezvani2647 commented 10 months ago

Hi @rezvani2647 I would like to participate in translating Updating Objects in State . regards

it's assign to you, good luck.

Jam-Hejrati commented 10 months ago

Dear @rezvani2647 Hi May I participate to translate the page "Editor Setup" ? Best regards.

rezvani2647 commented 10 months ago

Dear @rezvani2647 Hi May I participate to translate the page "Editor Setup" ? Best regards.

Of course. we will be glad. it's assigned to you, good luck.

Hadi-bakhshi commented 10 months ago

Dear @rezvani2647 Hello I would like to be a translation participant. May I translate page "Render and Commit" ? I can translate many more pages if it is possible.

Thanks in advance

faeghe-hajiabadi commented 10 months ago

Dear @rezvani2647 Hello I would like to be a translation participant. May I translate page "Render and Commit" ? I can translate many more pages if it is possible.

Thanks in advance

please check the list of taken ones, this one is taken