Azerbaijani Translation Progress
tesseralis opened this issue · 43 comments
For New Translators
To translate a page:
- Check that no one else has claimed your page in the checklist and comments below.
- Comment below with the name of the page you would like to translate. Take only one page at a time.
- Clone this repo, translate your page, and submit a pull request!
Before contributing, read the glossary 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) #1
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 (@GasimGasimzada) #3
- Tutorial (@GasimGasimzada) #5
- Languages (@saidfagan) #41
- Release Channels (@GasimGasimzada) #150
Basics
- Hello World (@Haqverdi) #8
- Introducing JSX (@Haqverdi) #27
- Rendering Elements (@GasimGasimzada) #89
- Components and Props (@azizaismayilova) #53
- State and Lifecycle (@saidfagan) #43
- Handling Events (@saidfagan) #50
- Conditional Rendering (@azizaismayilova) #77
- Lists and Keys (@GasimGasimzada) #94
- Forms (@GasimGasimzada) #90
- Lifting State Up (@GasimGasimzada) #92
- Composition vs Inheritance (@GasimGasimzada) #91
- Thinking in React (@GasimGasimzada) #93
API Reference
- React (@GasimGasimzada) #47
- React.Component (@GasimGasimzada) #76
- ReactDOM (@GasimGasimzada) #78
- ReactDOMServer (@GasimGasimzada) #79
- DOM Elements (@GasimGasimzada) #80
- SyntheticEvent (@GasimGasimzada) #81
- Test Utilities (@GasimGasimzada) #82
- Shallow Renderer (@GasimGasimzada) #83
- Test Renderer (@GasimGasimzada) #85
- JS Environment Requirements (@GasimGasimzada) #84
- Glossary (@GasimGasimzada) #86
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 (@GasimGasimzada) #5
- docs/nav.yml (@GasimGasimzada) #7
Next Steps
These are the next most important translations, ordered by importance:
Installation
- Getting Started (@GasimGasimzada) #103
- Add React to a Website (@GasimGasimzada) #107
- Create a New React App (@GasimGasimzada) #105
- CDN Links (@GasimGasimzada) #104
Hooks
Everyone is hooked on hooks! People are really excited for these and it would be great for them to be translated.
- Introducing Hooks (@GasimGasimzada) #141
- Hooks at a Glance (@GasimGasimzada) #140
- Using the State Hook (@GasimGasimzada) #135
- Using the Effect Hook (@GasimGasimzada) #137
- Rules of Hooks (@GasimGasimzada) #136
- Building Your Own Hooks (@GasimGasimzada) #142
- Hooks API Reference (@GasimGasimzada) #143
- Hooks FAQ (@GasimGasimzada) #145
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 (@GasimGasimzada) #112
- invalid-aria-prop (@GasimGasimzada) #112
- invalid-hook-call-warning (@GasimGasimzada) #147
- legacy-factories (@GasimGasimzada) #112
- refs-must-have-owner (@GasimGasimzada) #112
- special-props (@GasimGasimzada) #112
- unknown-prop (@GasimGasimzada) #112
Advanced Guides
- Accessibility (@azizaismayilova) #12
- Code-Splitting (@GasimGasimzada) #21
- Context (@GasimGasimzada) #24
- Error Boundaries (@GasimGasimzada) #46
- Forwarding Refs (@azizaismayilova) #37
- Fragments (@azizaismayilova) #38
- Higher-Order Components (@mehdiyev) #99
- Integrating with Other Libraries (@GasimGasimzada) #101
- JSX In Depth (@GasimGasimzada) #114
- Optimizing Performance (@GasimGasimzada) #128
- Portals (@GasimGasimzada) #108
- Profiler (@GasimGasimzada) #129
- React Without ES6 (@GasimGasimzada) #117
- React Without JSX (@GasimGasimzada) #116
- Reconciliation (@GasimGasimzada) #127
- Refs and the DOM (@GasimGasimzada)
- Render Props (@GasimGasimzada) #154
- Static Type Checking (@GasimGasimzada) #124
- Strict Mode (@GasimGasimzada) #125
- Typechecking With PropTypes (@GasimGasimzada) #119
- Uncontrolled Components (@GasimGasimzada) #121
- Web Components (@azizaismayilova) #39
FAQ
- APIs and AJAX (@GasimGasimzada) #6
- Babel, JSX, and Build Steps (@GasimGasimzada) #111
- Passing Functions to Components (@GasimGasimzada) #130
- Component State (@GasimGasimzada) #123
- Styling and CSS (@GasimGasimzada) #115
- File Structure (@GasimGasimzada) #120
- Versioning Policy (@GasimGasimzada) #122
- Virtual DOM and Internals (@GasimGasimzada) #118
Testing
- Overview (@GasimGasimzada) #131
- Testing Recipes (@GasimGasimzada) #134
- Testing Environment (@GasimGasimzada) #132
Concurrent Mode (Experimental)
- Introducing Concurrent Mode (@mehdiyev) #178
- Suspense for Data Fetching (@GasimGasimzada) #171
- Concurrent UI Patterns (@GasimGasimzada) #172
- Adopting Concurrent Mode (@GasimGasimzada) #175
- Concurrent Mode API Reference (@GasimGasimzada) #176
Contributing
Priority: Low
- How to Contribute (@GasimGasimzada) #160
- Codebase Overview (@GasimGasimzada) #166
- Implementation Notes (@GasimGasimzada) #168
- Design Principles (@mehdiyev) #169
Components
Components in src/components that have some text in them.
- CodeEditor (@GasimGasimzada)
- CodeExample (@GasimGasimzada)
- ErrorDecoder (@GasimGasimzada) #149
- LayoutFooter (@GasimGasimzada)
- LayoutHeader (@GasimGasimzada)
- MarkdownPage (@GasimGasimzada)
Other
- Community (@GasimGasimzada) #177
Config
- Gatsby Config file (@GasimGasimzada) #148
Of course I want to translate everything, but let's start with the first page, that is Home Page
@Haqverdi choose a page that you would like to work on and I will assign you the task in this issue. I am currently doing Homepage and Tutorial.
@Haqverdi choose a page that you would like to work on and I will assign you the task in this issue. I am currently doing Homepage and Tutorial.
okay, then i will work on Hello World Page
I have added you to "Hello World" checklist item. Also, please refer to the glossary of terms when translating to have consistency across translations (it is still in Work in Progress but we are getting there :)).
Member
@Haqverdi any progress on "Introducing JSX"?
Hi guys. I would like to participate in the translation process, too. I want to translate the small Languages page for a start.
@saidfagan I would suggest you start with the basics "State and Lifecycle" but you can also start from Languages page. Just fork the repo and send us a PR and we will merge it once everything is in order.
OK. Then please assign me State and Lifecycle page.
OK. Then please assign me State and Lifecycle page.
done
@mehdiyev Hello, are you going to be doing "Higher Order Components"?
@GasimGasimzada yes please, assign me to HOC page
Done! In the future, when wanting to do certain translation, please comment here; so that, we know what is everyone working on.
@Haqverdi any updates on Rendering Elements?
@Haqverdi could you please provide us with a time frame on when you are going to finish "Rendering Elements"?
@saidfagan is there another translation that you want to pick up on? If you do, please comment here and I will assign your name here.
I am very sorry for the fact that I could not answer for a long time, approximately it will be possible in a week
Great! Thank you for the update!
Handling Events, please
@saidfagan assigned you to "Handling Events"
I have taken React.Component API Reference
@saidfagan could you start working on "Rendering Elements" page?
@saidfagan could you start working on "Rendering Elements" page?
Yes, please
Done!
@mehdiyev any updates on HOC?
@saidfagan @azizaismayilova @Haqverdi
I have finished 10 translations (all “API Reference” and 1 translation left in “Core Concepts”). They are all available in Pull Requests. Could you please review the translations for anything I may have missed (grammatical, syntactical, doesn’t matter)? Each PR has a link in it (deploy-X.netlify.com). By following the link, you can find the changes by navigating to the appropriate documentation.
You can write your review in Azerbaijani. There is no restriction on what language you use to write your reviews as long as we can read and fix the changes :)
If you do review, just comment here on which PR you will be working on; so that, two people do not end up reviewing the same thing.
—
If you do review and find mistakes, in the PR, please create a list with line numbers. If mistake is a 1-2 words, please make the mistakes bold. For example, let’s say that I have written “Anket sahəsində olan dəyəri müəyənləşdirmək lazımdır” (one “y”) in line 130. In order to show the mistakes, the list will look like the following:
- Line 130: dəyəri müəyənləşdirmək lazımdır
@mehdiyev any updates on HOC?
I have finished translation. Sorry for late response
@mehdiyev it is going to take a while to review your PR since we have 7 more PRs in queue, waiting to be reviewed. If you would like to work on another page, please check the the list above and without a name and let us know. Currently, the main focus is translating “Advanced Guides.” So, choose any unassigned item from the list and comment here; so, I can add your name next to the item to avoid potential conflicts.
@GasimGasimzada okay, then assign me Refs and the DOM page, please.
Done
@mehdiyev any info on Refs and the DOM page?
Additionally, glossary is now moved to a file: https://github.com/reactjs/az.reactjs.org/blob/master/glossary.md. You can click glossary button in this issue or at the top of the README file.
Great! We are so close to finishing! Currently, I will self-review Testing Recipes and move to Hooks. After you are done with Refs and DOM, could you please do Render Props?
Can you please assign me Design Principles page?
Btw, sorry for not getting back with refs&dom page. I did not make it in time.
Done! Please finish it by Friday.
I would like to start with "CONCURRENT MODE" phase. Can you assign me please?
Done!
@mehdiyev any updates on Concurrent Mode Intro?
@GasimGasimzada almost done. Tomorrow I'll open PR.
Thank you everyone for your contributions. Since we have reached 100%, it is time to close this issue 🎉
Hi folks,
Just a heads-up that we've done our best to bring main and legacy branches up-to-date with upstream. This brings you to the latest visual design and sets up all the redirects. We don't anticipate more changes necessary on legacy. For main, there's a few things you need to be aware of:
- Keep in mind translating UI is best done closer to the end. We plan to make non-trivial code changes to the repo over the next few months. So it's best to focus on the content rather than on UI components.
- The homepage is untranslated so ideally it would be good if you could do a pass at that. For now, unfortunately it requires messing with the code file.
Thank you so much for your cooperation!