Description
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 and style guide to understand how to translate various technical and React-specific terms.
You can use the Crowdin as a base for your translation. Make sure to compare the content with the current React website to makes sure everything is up to date! (NOTE: delete this if the language doesn't have any Crowdin contributions)
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:
- Home Page (@tesseralis) Vietnamese Translation Progress #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 (@nampdn) Translate home #3
- Tutorial
Basics
- Hello World (@ltmylinh ) Task/translate hello world #9
- Introducing JSX (@phonglk) Translate Introducing JSX #7
- Rendering Elements (@ltmylinh) Translation for rendering elements page #12
- Components and Props (@tuyengabi)
- State and Lifecycle (@vkhanh74 translate state and lifecycle doc to Vietnamese #69)
- Handling Events (@ntban15) Translate Handling Events #17
- Conditional Rendering (@pnminh1710) Translate Conditional Rendering #21
- Lists and Keys (@NhanHoang8195) Translate lists and keys #19
- Forms (@pnminh1710)
- Lifting State Up (@cuongtran8) Bản dịch phần lifting state up #28
- Composition vs Inheritance (@cuongtran8) Translate page composition vs inheritance #32
- Thinking in React (@cuongtran8) Translate thinking in react page #25
API Reference
- React (@Quynh-Nguyen) Translate API Reference - React #20
- React.Component (@pthanh1703)
- ReactDOM (@Quynh-Nguyen)
- ReactDOMServer (@mduclehcm)
- DOM Elements (@hweeTan) Translate DOM Elements and SyntheticEvent pages #39
- SyntheticEvent (@hweeTan) Translate DOM Elements and SyntheticEvent pages #39
- Test Recipes (@luubinhan) docs(vietnamese): update testing-recipies.md #78
- Shallow Renderer (@hweeTan) translate shallow renderer and test renderer #53
- Test Renderer (@hweeTan) translate shallow renderer and test renderer #53
- JS Environment Requirements (@Ryan-LT)
- Glossary (@DungGramer) Update reference-glossary #226
Navigation
These are the navigation links that appear in the sidebar. Possibly wait until
the corresponding sections are translated to do these.
- tutorial/nav.yml
- docs/nav.yml (@fozg) Translate Navigation & Profiler API #199
- docs/footerNav.yml @fozg) Translate Navigation & Profiler API #199
- docs/headerNav.yml @fozg) Translate Navigation & Profiler API #199
Next Steps
These are the next most important translations, ordered by importance:
Installation
- Getting Started (@quyctd) Translate getting-started.md #113
- Add React to a Website
- Create a New React App (@nguyenary) Translate CDN Links page and Create a New React App page #162
- CDN Links (@hiimnhan ) Translate/cdn links #157
- Release Channels (@vovantamvn) Translate release channels #232
Hooks
Everyone is hooked on hooks! People are really excited about these and it would be great for them to be translated.
- Introducing Hooks (@hieuhani) Translate hooks introduction page #22
- Hooks at a Glance (@hieuhani) Translate hooks overview page #23
- Using the State Hook(@phonglk)
- Using the Effect Hook (@luubinhan) translate using effect hook #44
- Rules of Hooks (@luubinhan) translate using effect hook #44
- Building Your Own Hooks (@lPaths) feat: translate building your own hooks page #195
- Hooks API Reference (@fozg) Translate Hooks API Reference #210
- Hooks FAQ
Testing
- Testing Overview (@lequangnamsoraly2009) feat/translate docs/testing.md #159
- Testing Recipes
- Testing Environments (@danglequocbao001) feat: translate testing-environments (done) #182
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 (@kctrnn) Translate Don't Call PropTypes Warning #174
- invalid-aria-prop (@dinhtrung1308) translate invalid-hook-call-warning and invalid-aira-prop #200
- invalid-hook-call-warning (@dinhtrung1308) translate invalid-hook-call-warning and invalid-aira-prop #200
- legacy-factories (@dinhtrung1308) translate legacy-factory #183
- refs-must-have-owner (@lequangnamsoraly2009) translate warnings/refs-must-have-owner.md #208
- special-props (@dinhtrung1308) trsanlate special-props #190
- unknown-prop (@lequangnamsoraly2009) translate warnings/unknown-prop.md #198
Advanced Guides
- Accessibility (@ThinhNu) Translate Accessibility to Vietnamese #29
- Code-Splitting (@ThinhNu) Translate code-spliting page #24
- Context (@hweeTan)
- Error Boundaries (@hweeTan)
- Forwarding Refs (@huykon) Translate document article "Forwarding Refs" #191
- Fragments
- Higher-Order Components (@hiimnhan) translate HOC #215
- Integrating with Other Libraries (@ncnthien) Translate: integrating-with-other-libraries page #222
- JSX In Depth (@pthanh1703) translate jsx-in-depth part #203
- Optimizing Performance (@hoangvanhoa1701) feat: translate docs Optimizing Performance page #212
- Portals (@huykon) Translate document article "Portals" #176
- Profiler API (@fozg) Translate Navigation & Profiler API #199
- React Without ES6 (@hoangvanhoa1701) feat: translate React Without ES6 page #180
- React Without JSX (@hoangvanhoa1701) feat: translate React Without JSX page #184
- Reconciliation (@hoangvanhoa1701) feat: translate docs Reconciliation page #193
- Refs and the DOM (@nguyentran-se) translate docs/refs-and-the-dom #206
- Render Props (@hphuocthanh) Translated docs/render-props #205
- Static Type Checking (@qhuu2742) static-type-checking.md translate #207
- Strict Mode (@nhannv) Translate Strict Mode #224
- Typechecking With PropTypes (@hoangvanhoa1701) feat: translate docs Typechecking With Proptypes page #219
- Uncontrolled Components (@ThaoLe366) Translate uncontrolled component #167
- Web Components (@nguyentran-se) translate docs/web-components #186
FAQ
- APIs and AJAX
- Babel, JSX, and Build Steps
- Passing Functions to Components
- Component State (@nguyenary) translate: faq component state page #168
- Styling and CSS
- File Structure (@tedle1997) Translate faq-structure.md #172
- Versioning Policy (@nguyenary) Translate versioning policy page #204
- Virtual DOM and Internals (@qhuu2742) faq-internals translate #181
Contributing
Priority: Low
- How to Contribute (@kvphan5)
- Codebase Overview (@beebapcay) Translate Codebase-Overview page #239
- Implementation Notes
- Design Principles (@beebapcay) Translate Design Principles page #234
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