Vietnamese Translation Progress

[tesseralis]

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. 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.

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

[anhphamduy]

Seems like the link to the glossary is dead. I believe it's supposed to be #2

[anhphamduy]

I'll do the tutorial page.

[tesseralis]

@anhphamduy D'oh, this issue is autogenerated and I forgot to actually make a glossary issue. Feel free to create one!

[nampdn]

Hello @anhphamduy, when will you plan to start the Tutorial translation?

[anhphamduy]

@nampdn By next week probably. Is it urgent?

[ltmylinh]

I will translate * Hello World * this weekend.

[phonglk]

I will do Introducing JSX

[ltmylinh]

Nam (@nampdn) ơi em update bạn @phonglk và @anhphamduy vào danh sách đóng góp translate tiếng việt nhé. Cám ơn em.

[phonglk]

I will continue to do Components and Props by this weekend

[nampdn]

@nampdn By next week probably. Is it urgent?

@anhphamduy It's the most high priority because we will need to complete home and tutorial first in order to make the first PR to official repo. Could you do it by the end of this week?

[tesseralis]

@nampdn Hmm, I wouldn't say you needed to do those two first. The entire "Core Pages" section, including "Basics" and "API Pages" should be done first, but in any order you feel okay with.

[phonglk]

Should we have a discussion channel that we can discuss things actively, may be Slack ?

[ltmylinh]

@phonglk I totally agree with you. It would be great if we have a Slack channel to discuss something about translation.

[ltmylinh]

Nam @nampdn ơi, em có xài Slack không?

[tesseralis]

@phonglk @nampdn there's a global React Translation slack that you can join here: rt-slack-invite.herokuapp.com

A couple of the other translation groups started their own channels there!

[phonglk]

Just joined there. also created the channel and invited you guys.
I am a bit busy now so my progress will be slow. Thank you for your understanding.

[ntban15]

Hi. I'll do Handling Events this weekend.

[Quynh-Nguyen]

Hi all.
I'll help API Reference - React page at nights and weekend.

[pnminh1710]

Hi all.
I will do Conditional Rendering page.

[NhanHoang8195]

Hi all,
I will do Lists and Keys page.

[NhanHoang8195]

I'm going to do React.Component.

[pnminh1710]

Hi all,
I'm going to do Forms page

[Quynh-Nguyen]

Hi all,
I'm going to do ReactDOM page.

[huyqdang]

Hi all, I can help with Accessibility.

[cuongtran8]

Hi, I finished "Thinking in react", can maintainer please have a look on that? Thanks

[cuongtran8]

I will translate 'Lifting State Up' page next

[kvphan5]

I'll translate the How to Contribute page under Contributing section

[vuon0029]

I can translate How to Contribute under Contributing if that's ok

[tedle1997]

Hi, since the high-priority sections are mostly translated, can we move on to the low-priority part? If that's a go I will do the Design Principle part.

[Ryan-LT]

Hi Ryan-LT...

Hi @hoangnv170752, You could follow the steps that I've comment in the post. Please DM me if you face any difficulties.
Welcome to the team!

[Ryan-LT]

Hi @kvphan5 and @vuon0029,

Since @kvphan5 is the first to register for this, Could you please pick another one? @vuon0029?

[kvphan5]

Hi @kvphan5 and @vuon0029,

Since @kvphan5 is the first to register for this, Could you please pick another one? @vuon0029?

Hey Ryan, can you mark my name next to the How to Contribute. I will be spending time on it 👍. I just want to make sure I'm not overlapping anyone.

[Ryan-LT]

Hey @kvphan5 on it

[kvphan5]

Ryan, I saw @vuon0029 next to How to Contribute instead of mine. Should I proceed still or move on to Codebase Overview? Since I have been working on the translation.

[Ryan-LT]

@kvphan5 it was a mistatke. Updated it. Many thanks

[Ryan-LT]

Hi Forks!

There are a few stale translations that need your help still, they're abandoned for a while now and it could be amazing if you can help us on that too.

To name a few:

React.Component (@NhanHoang8195)
ReactDOM (@Quynh-Nguyen)
ReactDOMServer (@mduclehcm)
Release Channels (@vovantamvn)
Error Boundaries (@hweeTan)
Codebase Overview
Implementation Notes
Design Principles

Again, Your help means a lot! 🙏

[kvphan5]

Hi Ryan, I’m working on it. Just juggling between work/school/contributions right now 😁. I will definitely get my section done by 11:59PM Saturday PST timezone, then move on to other sections if there’s any to be filled.

[Ryan-LT]

@kvphan5 sure, please take your time. no rush at all 😄

[vovantamvn]

@Ryan-LT Can you check #232 for me? Thank you.

[duc-tm]

@Ryan-LT i'll translate "React.Component" part. Please mark my name on the list

[Ryan-LT]

@Ryan-LT i'll translate "React.Component" part. Please mark my name on the list

Done! Thanks 🙇

[beebapcay]

I will translate "Design Principles" part.

[hphan9]

Hi team, Can I help to translate the ReactDOM part or FAQ: Passing Functions to Components part or any part that is still available?
@Ryan-LT
Please assign it to me. Thank you

[beebapcay]

I will translate "Codebase Overview" page

[huuthotn01]

I will translate "Implementation Notes" page

[mqnguyen5]

Hi @Ryan-LT, I would like to translate the Codebase Overview part of the documentation if no one is working on it at the moment. Can you assign it to me? Thanks.

[beebapcay]

Hi @mqnguyen5. I have already started translating that part

[mqnguyen5]

Oh sorry @beebapcay , I didn't see the name so I thought no one is working on it

[mqnguyen5]

@Ryan-LT are there any parts that need translation at the moment?

[mqnguyen5]

@Ryan-LT are there any parts that need translation at the moment?

[henryonsoftware]

Hi! I found some typos on translated pages. What should I do?

[gaearon]

Thanks to everyone who contributed to the old website translation!
Started a new issue for the new website: #345