[OLD] Legacy Arabic Translation Progress

[tesseralis]

Maintainer List

• @asantarissy
• @iRayan7
• @aladin002dz
• @Fcmam5
• @mohshbool
• @3imed-jaberi
• @splimter

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 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 any more, let the maintainers know so they can assign the page to someone else.

PS: Please use Hsoub's wiki as your reference but keep in your mind we need to keep the tech. terms in the English and Arabic language.
eg: unit testing (وحدات الاختبار), javascript (جافاسكريبت),...etc.

For Maintainers

When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:

• Home Page (@tesseralis) [OLD] Legacy Arabic Translation Progress #1

When PRs are merged, make sure to mark that page as completed!

• RTL Support (@asantarissy) RTL Support #8

Core Pages

To do before releasing as an "official" translation. Please translate these pages first.

• Home Page (@fkanout) Translate home page examples #36, Translate footer #37, Translate Home Page banner and page title #38 & Translate Header #39
• Tutorial (@3imed-jaberi) [Done] Translation of tutorial.md ..  #135

Basics

• Hello World (@maskeddeveloper) [DONE] hello-world.md ..  #125
• Introducing JSX (@asantarissy) Translating introducing-jsx.md #9
• Rendering Elements (@omar-dulaimi) Translating rendering-elements.md #10
• Components and Props (@asantarissy) Translating components-and-props.md #11
• State and Lifecycle (@3imed-jaberi) [Done] Translation of state-and-lifecycle.md  #115
• Handling Events (@aladin002dz) Translating 'handling-events.md' #21
• Conditional Rendering (@AdhamMoussa) Translating conditional-rendering.md #22
• Lists and Keys (@splimter) Done Translating-lists-and-keys.md #53
• Forms (@aladin002dz) Translating "forms" page, and a typo fixed #17
• Lifting State Up (@aladin002dz) Translating 'lifting-state-up.md' #25
• Composition vs Inheritance (@a-deeb) Translating 'composition-vs-inheritance.md' #29
• Thinking in React (@ahmedfarag36) Translating 'thinking-in-react.md' #31

API Reference

• React (@hgareeballa) Translating 'reference-react.md' #32
• React.Component (@splimter) Done Translating-reference-react-component.md #40
• ReactDOM (@splimter) Translating reference react dom.md #43
• ReactDOMServer (@splimter) Done Translating-reference-react-dom-server.md #71
• DOM Elements (@splimter) Done Translating-reference-dom-elements.md #44
• SyntheticEvent (@splimter) Translating reference events.md #45
• Test Utilities (@splimter) Done Translating-addons-test-utils.md #46
• Shallow Renderer (@splimter) Done Translating-addons-shallow-renderer.md #47
• Test Renderer (@splimter) Done Translating-reference-test-renderer.md #48
• JS Environment Requirements (@splimter) Translating reference-javascript-environment-requirements.md #49
• Glossary (@splimter) Translating reference-glossary.md #51

Navigation

These are the navigation links that appears in the sidebar. Possibly wait until
the corresponding sections are translated to do these.

• tutorial/nav.yml (@3imed-jaberi ) [Done] Translation of tutorial/nav.yml .. #136
• docs/nav.yml (@3imed-jaberi ) [DONE] Translation of docs/nav.yml #97

Next Steps

These are the next most important translations, ordered by importance:

Installation

• Getting Started (@mhmdAljefri) Translating getting-started.md #54
• Add React to a Website (@mhmdAljefri) Translating add-react-to-a-website.md #55
• Create a New React App (@mhmdAljefri) Translating create-a-new-react-app.md #56
• CDN Links (@mohshbool) Translated cdn-links page #70
• Release Channels (@mohamedsgap) Release channels translate #205

Hooks

Everyone is hooked on hooks! People are really excited for these and it would be great for them to be translated.

• Introducing Hooks (@splimter) Done Translating-hooks-intro.md #57
• Hooks at a Glance (@splimter) Done Translating-hooks-overview.md #58
• Using the State Hook (@splimter) Done Translating-hooks-state.md #59
• Using the Effect Hook (@aladin002dz) Translating hooks-effect.md #60
• Rules of Hooks (@splimter) Done Translate-hooks-rules.md #61
• Building Your Own Hooks (@splimter) Done Translating-hooks-custom.md #63
• Hooks API Reference (@splimter) Done Translating-hooks-reference.md #68
• Hooks FAQ (@splimter) Done Translating-hooks-faq.md #69

Testing

• Testing Overview (@mohdule) [DONE] Translating testing overview #195
• Testing Recipes (@mohamedsgap) [DONE ] Testing Recipes .. #198
• Testing Environments (@mohamedsgap) Finish Translating Testing Environments #202

Concurrent Mode ( New )

• Introducing Concurrent Mode (@Fcmam5) WIP: Translate "Introducing Concurrent Mode" #207
• Suspense for Data Fetching (@mohamedsgap) [DONE] Translated "Suspense for Data Fetching" #208
• Concurrent UI Patterns (@yusuf963) initial start and update the head of concurrent-mode-patterns.md #454
• Adopting Concurrent Mode (@mohamedsgap) [DONE] Translating "Adopting Concurrent Mode" #218
• Concurrent Mode API Reference (@mohamedsgap) [Done] Translate Concurrent Mode API Reference #225 (@3imed-jaberi) [DONE] Improve Concurrent Mode API Ref #243

Warnings

These are the pages that you get when you click the links in the console (e.g. https://reactjs.org/warnings/dont-call-proptypes.html). People tend to search these, so please don't translate the error message itself.

• dont-call-proptypes (@mohshbool) translated warnings/dont-call-proptypes #121
• invalid-aria-prop (@mohshbool) translated warnings/invalid-aria-prop #123
• invalid-hook-call-warning (@mohshbool) done translating warnings/invalid-hook-call #126
• legacy-factories (@mohshbool) [Done] translated warnings/legacy-factories #145
• refs-must-have-owner (@mohshbool) translated warnings/refs-must-have-owner #134
• special-props (@mohshbool) [Done] translated warnings/special-props #141
• unknown-prop (@mohshbool) translated warnings/unknown-props #132

Advanced Guides

• Accessibility (@splimter) Translating accessibility.md #64
• Code-Splitting (@splimter) Done Translating-code-splitting.md #65
• Context (@splimter) Done Translating-context.md #66
• Error Boundaries (@aminebenkeroum) Error Boundaries Page #67
• Forwarding Refs (@mohshbool) Translated forwarding-refs #91
• Fragments (@splimter) Done Translating-fragments.md #74
• Higher-Order Components (@aladin002dz) Done translating high-order components #119
• Integrating with Other Libraries (@3imed-jaberi) [Done] Translation of intergrating-with-other-libraries.md .. #102
• JSX In Depth (@3imed-jaberi) [Done] Translation of jsx-in-depth.md .. #103
• Optimizing Performance (@Fcmam5) [Done] Start translating "Optimizing Performance" #96
• Portals (@3imed-jaberi) [Done] Translation of portals.md .. #101
• Profiler API (@ahmed-abdulhuy) Profiler api #395
• React Without ES6 (@aladin002dz) Translating - React without ES6 #93
• React Without JSX (@m1m6) [Done] React without JSX #78
• Reconciliation (@Fcmam5) [Done] Translate "Reconciliation" #99
• Refs and the DOM (@mohshbool) translate refs-and-the-dom #108
• Render Props (@Fcmam5) [Done] Translating Render props #105
• Static Type Checking (@3imed-jaberi) [Done] Translation of static-type-checking.md  #89
• Strict Mode (@3imed-jaberi) [Done] Translation of strict-mode.md  #92
• Typechecking With PropTypes (@AbdelkhalekESI) [DONE] typechecking-with-proptypes.md translation #80
• Uncontrolled Components (@3imed-jaberi) [Done] Translation of uncontrolled-components.md #95
• Web Components (@3imed-jaberi) [Done] Translation of web-components.md #94
• Web Components (@3imed-jaberi) [Done] Translation of web-components.md <fix /> #215

FAQ

• APIs and AJAX (@maskeddeveloper) [DONE] Translate AJAX and APIs FAQ Page reference to faq-ajax.md #83
• Babel, JSX, and Build Steps (@3imed-jaberi) [Done] Translation of faq-build.md .. #138
• Passing Functions to Components (@3imed-jaberi) [Done] Translation of faq-functions.md .. #139
• Component State (@maskeddeveloper) [Done] Translation of FAQ reference to faq-state.md #85
• Styling and CSS (@maskeddeveloper) [Done] Translating FAQ reference to faq-styling.md #86
• File Structure (@maskeddeveloper) [Done] translating faq-structure.md #88
• Versioning Policy (@maskeddeveloper) [Done] translating versioning #116
• Versioning Policy #minors-versus-patches
• Virtual DOM and Internals (@3imed-jaberi ) [Done] Translation of faq-internals.md ( FAQ / Virtual DOM and Internals )  #114

Contributing

Priority: Low

• How to Contribute (@Fcmam5) [Done] translate "How to Contribute" #120
• How to Contribute (@ahmed-abdulhuy) #branch-organization & #feature-flags [WIP] translate branch_organization & feature_flags #394
• Codebase Overview (@ahmedkrmn) [Work in progress] Translate docs/codebase-overview #131
• Implementation Notes (@mriiad) WIP: Translate "Implementation Notes" #372
• Design Principles

Components

Components in src/components that have some text in them.

• CodeEditor (@Fcmam5) [Done] translate components #110
• CodeExample (@Fcmam5) [Done] translate components #110
• ErrorDecoder (@Fcmam5) [Done] translate components #110
• LayoutFooter (@Fcmam5) [Done] translate components #110
• LayoutHeader (@Fcmam5) [Done] translate components #110
• MarkdownPage (@Fcmam5) [Done] translate components #110

Additional Translations

These are not the primary translation targets.

• Blog
• Community Translating community section #117
• Community - Meetups (@3imed-jaberi) [Done] Translation of meetups.md v2 ..  #221
• Community - Team

[tesseralis]

@22mahmoud, @SaifAsad, @Emmanuel-Melon, @iRayan7 how's it going? Do you have any questions or need any help getting started?

[fawzisf]

I would love to help! i see no pages are currently taken so i will start by the home page.

[Emmanuel-Melon]

@22mahmoud, @SaifAsad, @Emmanuel-Melon, @iRayan7 how's it going? Do you have any questions or need any help getting started?

Yes, I do. Which repository should I clone and push changes to? Is it https://github.com/reactjs/ar.reactjs.org or https://github.com/reactjs/reactjs.org?

[fawzisf]

@Emmanuel-Melon This one.

[Emmanuel-Melon]

@Emmanuel-Melon This one.

Thanks, I have just cloned it. BTW, have you started working on the home page?

[fawzisf]

No, but willing to start today.
I think someone should work on the glossary for the technical terms.

[Emmanuel-Melon]

No, but willing to start today.

Make a pull request so I could attach your name to the page you're editing.

[fawzisf]

@tesseralis i think we will need some help as well to transform the website to RTL

[tesseralis]

@fawzisf I'll look into it! For now, maybe looking at what the Persian translation is doing might be useful: https://github.com/reactjs/fa.reactjs.org/pull/7/files

[IsraaMoqbel]

Hey,
I'm interested to contribute to this, I'll do the Hello world page.

[omar-dulaimi]

Can I join you guys please?
BTW "unit testing" = "اختبار الوحدات"

[22mahmoud]

Hey @IsraaMoqbel , Please open a PR, So I could assign you to this page

[asantarissy]

Can I join you guys please?
BTW "unit testing" = "اختبار الوحدات"

Thanks @omar-dulaimi, please read The Contribution Guidelines, pick a page to translate and open a PR so I can assign you to it. enjoy!

الله حيو النشمي 😄

[omar-dulaimi]

Can I join you guys please?
BTW "unit testing" = "اختبار الوحدات"

Thanks @omar-dulaimi, please read The Contribution Guidelines, pick a page to translate and open a PR so I can assign you to it. enjoy!

الله حيو النشمي 😄

Thanks man @tesseralis , I have read them all just a while ago. I'm going to pick 'rendering elements' if I may.
الله يحييك 😁

[asantarissy]

Can I join you guys please?
BTW "unit testing" = "اختبار الوحدات"

Thanks @omar-dulaimi, please read The Contribution Guidelines, pick a page to translate and open a PR so I can assign you to it. enjoy!
الله حيو النشمي 😄

Thanks man @asantarissy , I have read them all just a while ago. I'm going to pick 'rendering elements' if I may.
الله يحييك 😁

That's great @omar-dulaimi, please create a PR so I can assign you to this page.

[omar-dulaimi]

Can I join you guys please?
BTW "unit testing" = "اختبار الوحدات"

Thanks @omar-dulaimi, please read The Contribution Guidelines, pick a page to translate and open a PR so I can assign you to it. enjoy!
الله حيو النشمي 😄

Thanks man @asantarissy , I have read them all just a while ago. I'm going to pick 'rendering elements' if I may.
الله يحييك 😁

That's great @omar-dulaimi, please create a PR so I can assign you to this page.

I just did @asantarissy Thank you.

[aladin002dz]

Salam, Hello everyone,
I think we need to create a facebook group for all participants, for discussions, collaborations and sharing tips and experiences, and lead the project to a brilliant result.
Cheers,
Mahfoudh Arous

[aladin002dz]

@fawzisf I'll look into it! For now, maybe looking at what the Persian translation is doing might be useful: https://github.com/reactjs/fa.reactjs.org/pull/7/files

indeed, I found some useful markdown tags in the project like these:

<h1 dir="rtl">
<p dir="rtl">
...

[asantarissy]

Salam, Hello everyone,
I think we need to create a facebook group for all participants, for discussions, collaborations and sharing tips and experiences, and lead the project to a brilliant result.
Cheers,
Mahfoudh Arous

Thanks @aladin002dz, I sent you a link on messenger to join us on slack.
Also, please check this #8 merged PR for the RTL implementation.

Enjoy.

[splimter]

i'll take Basics Lists and Keys

[asantarissy]

i'll take Basics Lists and Keys

That's great @splimter, please create a PR so others won't work on the same page.

Enjoy!

[a-deeb]

Hey guys, can I help translate the \ar.reactjs.org\content\docs\Composition-vs-Inheritance page?

[ahmedfarag36]

Hello good enthusiastic people;
This idea of improving the Arabic content never left my head so I am so happy to help,
I have been learning react for a while and read many of docs pages.
Ready to translate:

• the tutorial or
• thinking in react 👍.

[asantarissy]

Hey guys, can I help translate the \ar.reactjs.org\content\docs\Composition-vs-Inheritance page?

Sure @a-deeb, please do the following:

• Read this issue
• Check our Glossary and Style Guide
• Pick a page to translate
• Create a PR
• And enjoy! 😄

[asantarissy]

Hello good enthusiastic people;
This idea of improving the Arabic content never left my head so I am so happy to help,
I have been learning react for a while and read many of docs pages.
Ready to translate:

• the tutorial or
• thinking in react 👍.

@ahmedfarag36 and we would be more than happy to have you on board.
Read this issue and check our Glossary and Style Guide, the tutorial page is already taken, maybe you can start on Thinking in React page.

Please create a PR so I can add you here.

Cheers!

[awnigharbia]

Hey 👋,
Am gonna take the Introducing Hooks page.

[asantarissy]

Hey 👋,
Am gonna take the Introducing Hooks page.

Hey @awnigharbia, that's great, please create a new pull request so I can assign you to this page.
Quick question, what would you translate Hooks in arabic, Hsoub used الخطافات but I'm not sure if it's the right translation?

[awnigharbia]

Hey @asantarissy, I don't think Hooks word needs to be translated, since it have other definitions in Arabic, So I'll keep it as it is in English without no confusing to the reader, so they'll know it's a name of a feature added to react and doesn't have a meaning in Arabic.

[asantarissy]

Hi guys, I would like to translate "Concurrent UI Patterns" page

Thank you for joining the team @yassinhussein, please go ahead I'll assign the page to you.

• Read this issue
• Check our Glossary and Style Guide
• Pick a page to translate
• Create a PR
• And enjoy! 😄

[maqalaqil]

I would love to take a page please assign me whatever is available Versioning Policy || profiler API

[3imed-jaberi]

Welcome @maqalaqil 👋🏻, it's yours.

[maqalaqil]

Thank you :D

[tech-chieftain]

Hey all, would love to help you guys with this. Can you assign Implementation Notes & Design Principles to me?

[mriiad]

Hi guys,
I would like to translate 'Implementation Notes' page, would it be possible to assign it to me please ?
@3imed-jaberi @Aissaoui-Ahmed, @aladin002dz, @asantarissy, @Fcmam5
Thank you!

[3imed-jaberi]

Hello @mriiad, Sure you can take it. You need to submit a PR.

[3imed-jaberi]

Hello @tech-chieftain @maqalaqil @yassinhussein,

Are there any updates about the pages you took?

[mriiad]

Hello @mriiad, Sure you can take it. You need to submit a PR.

Hello again @3imed-jaberi

Thanks for the quick reply, here's the PR associated to this task #372

Could you just add all the suitable labels and assign yourself as a reviewer please ?

Thank you!

[tech-chieftain]

Hey @3imed-jaberi, as Implementation Notes was assigned to @mriiad I can still work on Design Principles. Can you please assign it to me so others can focus on other pages? It will be ready in the next couple of days. Thanks

[maqalaqil]

Hey @3imed-jaberi ill have the PR ready today.

[ahmed-abdulhuy]

Hi guys,
I would like to translate the 'how to contribute' #branch-organization & #feature-flags page would it be possible to assign it to me, please?
Thank you!

[Aissaoui-Ahmed]

@ahmed-abdulhuy you can open PR
Thank you for your contribution

[ahmed-abdulhuy]

I would like to translate the 'Profiler API' page would it be possible to assign it to me, please?
Thank you!

[3imed-jaberi]

@tech-chieftain @maqalaqil, if you take any page please open a draft pr to help me to assign it to you!

[FettahAud]

Hey, I would like to translate "Design Principles" in Contributing section
Which is not assigned to anyone as I can see in the list

[yusuf963]

Hi, I will take Concurrent mode Patterns , it seems available in the above list - thanks

[yusuf963]

also I did an initial start and translate the head of concurrent-mode-patterns.md file in this draft PR #454
@3imed-jaberi can you reserve the file for me please! it read as Concurrent UI Patterns

[3imed-jaberi]

Hello guys, first let's say RAMADHAN MOUBAREK ☪︎❤️.

I would say, in the coming days, we will start the translation for the new website version.
For that, I will create a new progress-tracking issue, and in the meanwhile, the missing pages here are still available for translation.

[gaearon]

I created #464 for the new translation. Let's coordinate there!