Urdu Translation Progress

[tesseralis]

Maintainer List

• @jabranr
• @armujahid
• @ahmadawais
• @abdullah1908

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 find that you can't commit any more, 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:

• Home Page (@tesseralis) Urdu Translation Progress #1
• RTL Support (Add RTL support #4)

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

Core Pages

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

• Home Page (@Sanaullahbugti) Home Page #9
• Tutorial (@shahzad31) Tutorial Page Urdu Translation #10

Basics

• Hello World (@jabranr) Translate Hello World page #2
• Introducing JSX (@arximughal) Translate Introducing JSX page #5
• Rendering Elements (@owais4321) Translating Rendering Elements page #11
• Components and Props (@viveksharmaui) Components and Props #13
• State and Lifecycle (@aaftab1441) State and Lifecycle #15
• Handling Events (Translate Handling Events Page. #22)
• Conditional Rendering (@asheerrizvi) (Translate Conditional Rendering page #26)
• Lists and Keys
• Forms
• Lifting State Up
• Composition vs Inheritance
• Thinking in React

API Reference

• React
• React.Component
• ReactDOM
• ReactDOMServer
• DOM Elements
• SyntheticEvent
• Test Utilities
• Shallow Renderer
• Test Renderer
• JS Environment Requirements
• Glossary

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
• docs/nav.yml

Next Steps

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

Installation

• Getting Started
• Add React to a Website
• Create a New React App
• CDN Links

Hooks

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

• Introducing Hooks
• Hooks at a Glance
• Using the State Hook
• Using the Effect Hook
• Rules of Hooks
• Building Your Own Hooks
• Hooks API Reference
• Hooks FAQ

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
• invalid-aria-prop
• invalid-hook-call-warning
• legacy-factories
• refs-must-have-owner
• special-props
• unknown-prop

Advanced Guides

• Accessibility
• Code-Splitting
• Context
• Error Boundaries
• Forwarding Refs
• Fragments
• Higher-Order Components
• Integrating with Other Libraries
• JSX In Depth
• Optimizing Performance
• Portals
• React Without ES6
• React Without JSX
• Reconciliation
• Refs and the DOM
• Render Props
• Static Type Checking
• Strict Mode
• Typechecking With PropTypes
• Uncontrolled Components
• Web Components

FAQ

• APIs and AJAX
• Babel, JSX, and Build Steps
• Passing Functions to Components
• Component State
• Styling and CSS
• File Structure
• Versioning Policy
• Virtual DOM and Internals

Contributing

Priority: Low

• How to Contribute
• Codebase Overview
• Implementation Notes
• Design Principles

Components

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

• CodeEditor
• CodeExample
• ErrorDecoder
• LayoutFooter
• LayoutHeader
• MarkdownPage

Additional Translations

These are not the primary translation targets.

• Blog

Community

• Courses (@mhkasif) Translate Courses page #21

[ahmadawais]

Howdy, @tesseralis!
I'd love to join the Reactjs Org on GitHub to translate React's resource in Urdu.

I'm one of the Locale Managers at WordPress for Urdu and helped arrange several meetups for consistently translating WordPress in Urdu.

Can you invite me (username ahmadawais) in so I can help manage the local community along with my dear friend @jabranr and hopefully along with @saqibameen @ahmadbilalme. Would also love to conduct a small meetup in March about this.

Looking forward, peace! ✌️

[jabranr]

@ahmadawais welcome! 🎉 I've added you as member. You also need a small PR in this repository (https://github.com/reactjs/reactjs.org-translation) to update list of maintainers for Urdu. Refer to their readme for more info.

I am currently working on some basic guidelines, hopefully be able to share soon. For that purpose, I have created an issue #3 for discussions and everyone's input in this regard.

[saqibameen]

Thanks for the mention @ahmadawais. Would definitely love to contribute to this effort. 🤞

[jabranr]

This is great! When ready, please create an issue to claim a page from above list so it can be assigned.

[ahmadawais]

Thanks a lot @jabranr looking forward to contributing.

[abdullah1908]

@jabranr as mentioned on the PR, I am also interested to maintain the translation :) You can add me as well in the maintainers list.
Thank you

[jabranr]

@abdullah1908 I would suggest the same as @armujahid had; to create a PR here in this repository and claim a page for translation. You will have to claim a page for yourself by looking into what suites you best. It is difficult for us to assign a page to you.

Also do you want to discuss your idea of adding Urdu strings in #3?

[abdullah1908]

Thanks @jabranr ☺️
Sure, I would love to discuss& share ideas.

[arximughal]

Hi @jabranr , I'd love to translate Introducing JSX.

[arximughal]

@jabranr Here's an issue #5, you can assign it to me.

[tesseralis]

Hey folks! How are things going here? @jabranr @arximughal how are your translations going?

[jabranr]

Hi @tesseralis, thanks for checking. I had been quite busy lately so have not done much. I aim to get back on couple of things I started earlier over this weekend.

What is your status @arximughal?

[arximughal]

Hi @tesseralis @jabranr, sorry for checking in late. I am actually a little busy with some personal stuff. I am moving to a new place (yay!). But the translation is going well. I'll submit the first version this weekend for you guys' review.

[Sajid-Ali]

Hi @tesseralis @jabranr I would love to contribute React Docs translation in to Urdu please add me. I have commented in the slack channel about React Urdu translation.

[jabranr]

Hi @Sajid-Ali, welcome and thank you for your interest in translating React docs. First of all you need to choose one page that you want to start translating from. To do this, create an issue in this repository (here is an example) and then one of us can assign you that page in the list given above.

In order to contribute translation, you can always start by forking this repository and making a pull request back to it. If you have any question, please feel free to ask.

[jabranr]

@tesseralis quick question. Are we able to use netlify app to preview builds in submitted PRs? I am asking because it seems to be already installed in this repo.

[tesseralis]

@jabranr sure!

[jabranr]

I have setup a PR commit hook with netlify so it will make a preview-able build for each PR submitted in this repository. The most recent build based on #6 is available at https://ur-react-docs.netlify.com/

Beware that URLs will be dynamic and unique for each build. Those should be available inside the PR going forward.

[armujahid]

https://ur.reactjs.org is now up.

[shahzad31]

I would like to contribute to this, i can pick up tutorials page i have create an issue , kindly assign it to so that i don't create a conflicting progress.

[jabranr]

Sure @shahzad31. welcome aboard!

[owais4321]

Hello @jabranr I would like to contribute to this, I want to take Rendering Elements page for translation thanks

[jabranr]

@owais4321 Welcome. Sure. You need to create an issue with a title describing the page you wish to work on. Let us know here and we then assign it to you in list above.

[owais4321]

Thanks Jabran for having me on board I have opened up an issue for translating rendering element page

…

________________________________ From: Jabran Rafique⚡️ <[email protected]> Sent: Monday, July 22, 2019 2:17 AM To: reactjs/ur.reactjs.org <[email protected]> Cc: owais4321 <[email protected]>; Mention <[email protected]> Subject: Re: [reactjs/ur.reactjs.org] Urdu Translation Progress (#1) @owais4321<https://github.com/owais4321> Welcome. Sure. You need to create an issue with a title describing the page you wish to work on. Let us know here and we then assign it to you in list above. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub<#1>, or mute the thread<https://github.com/notifications/unsubscribe-auth/AJQSPPAM3PN33FQHNL5RZZ3QAV3IZANCNFSM4G2MVTSA>.

[aaftab1441]

Hello @jabranr i would like to contribute to this effort and i have created an issue #10 please assign it to me.

[jabranr]

@aaftab1441 Welcome! Did you mean #15? Nevertheless, I have assigned it to you. Looking forward to your PRs.

[mhkasif]

I would like to contribute in translating files to urdu.
I converted community/courses.md file already and looking forward to convert more files.

Do i have my own choice to select?

Thanks.

[jabranr]

@mhkasif Welcome. Yes you have your own choice. Just choose the one from the list above and shout here we those can be assigned to you. It is important so that there is no duplicate work in parallel.

[asheerrizvi]

Hello,

I would like to translate the "Handling Events" page. I have opened an issue for the same.

Thanks!

[mumairofficial]

I am observing that there a couple of PR which are actually closed or inactive for more than a year. I think those assignments should be cleared out and available to others.

[asheerrizvi]

Would like to take one from #2, #5, #10, #11, #13 and #15 if they are inactive. Will that be possible @jabranr ?

[jabranr]

@asheerrizvi hard to say. People who have assigned these tasks are in better position to answer that. You are free to choose anything else from the rest of the list anyway.

[asheerrizvi]

@jabranr cool then, I will take "Conditional Rendering" and start it over the weekend.

[jabranr]

@asheerrizvi I have created a ticket #26 for you. Feel free to add more details to it.

[jabranr]

The translation work is now on hold to wait for new docs to replace current ones – as all this may require rework soon.

Ref: https://twitter.com/rachelnabors/status/1451465802981560330

[jabranr]

Hi everyone, today we can start working on translations for new beta docs. I have created a new issue with list of pages for these new docs. More information in #59

See you all there!

[MrSlimCoder]

@jabranr we need more members for this translation work can I work on outreach will share it with other's otherwise we will close 2nd issue as well.

[jabranr]

@TheSlimCoder Agreed. Yes great.

Regarding closing #2 and more, I think we will need a cleanup here so we start fresh for the new docs.

[MrSlimCoder]

@jabranr I will try uploading a video on youtube for our React Urdu docs initiative and will ask more and more open-source members to contribute within the repo.

Thanks!

[jabranr]

@TheSlimCoder great and do share a link with us here.

[humzahaseeb]

Hello, @jabranr
I'd love to join the Reactjs Org on GitHub to translate React's resource in Urdu.

As I'm myself learning React for sometime now, I'd love to make my contribution towards translating React into my native language Urdu and make it accessible to everyone in my local community to learn React.

Can you invite me so I can start making my contributions (username @Haseebhamza)

Looking forward, peace 🤞

[zainzafar90]

Hello, @ahmadawais

I want to contribute to the react community for people who want to read the docs in urdu. Can you invite me (username @zainzafar90)

Thanks

[jabranr]

Hi @Haseebhamza and @zainzafar90,

Fantastic that you both want to join in the efforts. Even greater news is that you do not need any invites to take part. All you need to do is to create a new issue and assign a page to yourself and start cracking. Here is the list of pages to be translated:

#59

Good luck! 👍🏼

[MrSlimCoder]

@jabranr here is a video link: https://www.youtube.com/watch?v=WfF682j2Kfo

[ahmadawais]

Best of luck @zainzafar90 🙌

[estevam5s]

Because I want to stay on top of everything that goes on in this organization and of course, as a good dev, you have to know about the challenges of this incredible world of programming. Can you invite me (username @Estevamsl)

[gaearon]

It looks like this translation has stalled, and is now very outdated.
I'm going to archive this repo, but if someone wants to pick up, please start a new effort.