Open gaearon opened 1 year ago
Let's all try to not keep multiple PRs alive at the same time by a single contributor. Let's not work at multiple pages at the same time as well.It would be ideal to start one after completing the previous one. If a PR is stuck with review, we can be assigned and lock another page for us.We can start working by opening a branch. This will help us all keep the work flow steady and seamless. Otherwise, with a higher number of contributors, PRs could get messed up.
For simplicity and cleanness I deleted old Assigning comments that are useless.
Yes vai. I want. Please allow me
I would love to translate State: A Component's Memory
@RazuAhmad and @moinul192000 assigned to both of you. Would you please make sure you can see your name right after the page check box list above?
I can not commit my new changes, recently I translated a whole new page but can not commit anymore. Can you guys help me figure this out ?
Most likely a linter issue.
Have you committed once yet to that branch? If yes please give a PR and comment the link here. We'll take the conversation there.
If not please join our discord server. The link is in the previous comment and share your file there.
It'd be easier to help if we can see the code.Thanks for your patience.
Ok, I'm sharing this on discord. thanks
I would like to work on the react: <Suspense>
page https://react.dev/reference/react/Suspense
I would like to work on the
react: <Suspense>
page https://react.dev/reference/react/Suspense
@nz-m Assigned to you! If you feel the page is too large to do in a single PR you can split that into 2/3 PR. Please have a look at the docs and Glossary
Hi there, I would like to translate react
: Hooks > useContext
page. https://react.dev/reference/react/useContext
Assigned to you! If you feel the page is too large to do in a single PR you can split that into 2/3 PR. Please have a look at the docs and Glossary
@asif-jalil Assigned to you! If you feel the page is too large to do in a single PR you can split that into 2/3 PR. Please have a look at the docs and Glossary. You can join our discord https://github.com/reactjs/bn.react.dev/issues/26
hello, I want to translate Quick Start. Please assign me to the page. thanks, shuvo
hello, I want to translate Quick Start. Please assign me to the page. thanks, shuvo
I am sorry, but quickstart is already assigned.
Please choose a different page from the list. Choose a page that has no name beside it.
hello, I want to translate Quick Start. Please assign me to the page. thanks, shuvo
I am sorry, but quickstart is already assigned.
Please choose a different page from the list. Choose a page that has no name beside it. ok. no problem , please assign me to Writing Markup with JSX .
hello, I want to translate Writing Markup with JSX. Please assign me to the page. thanks, shuvo
hello, I want to translate Writing Markup with JSX. Please assign me to the page. thanks, shuvo
@AhmdShuvo Assigned to you! If you feel the page is too large to do in a single PR you can split that into 2/3 PR. Please have a look at the docs and Glossary. You can join our discord https://github.com/reactjs/bn.react.dev/issues/26
Hi there, I would like to translate react: Hooks > useRef page. https://react.dev/reference/react/useRef
Hi there, I would like to translate react: Hooks > useRef page. https://react.dev/reference/react/useRef
@MostofaNobiTanveer Assigned to you! If you feel the page is too large to do in a single PR you can split that into 2/3 PR. Please have a look at the docs and Glossary. You can join our discord https://github.com/reactjs/bn.react.dev/issues/26
Hi, I would like to translate -> Adding Interactivity:Queueing a Series of State Updates
Hi, I would like to translate ->
Adding Interactivity:Queueing a Series of State Updates
Assigned. Thanks a lot for showing interest. Please read the rules and we welcome you to our discord server. You'll find all the details in other issues. Thanks again.
Hi there, I would like to translate react: Hooks > useDebugValue. Page: https://react.dev/reference/react/useDebugValue
I would like to translate "Preserving and Resetting State."
Self Assigned Hydrateroot.
I would like to translate "Preserving and Resetting State."
Assigned. Please read previous comments and issues for better understanding. Thanks a lot for showing interest.
I'd like to do useId in react hooks.
Assigned. Please read previous comments and issues for better understanding. Thanks a lot for showing interest.
clientApi-hydrateroot done. PR is open -> #53
Self assigned reactLcomponents index page. That is also done. PR will be posted after previous one is merged.
Self assigned
React components index (#58) and react components fragment (#57) are PRed -drafted-closed. I'll reopen the PRs as soon as #53 is reviewed and merged @nomandhoni-cs @moshfiqrony vai please have a look at it when convenient. Self assigning react-components-profiler
Hi there, I would like to translate API Reference->useReducer.
Hi there, I would like to translate API Reference->useReducer.
Assigned
Render done. Self assigned hydrate.
Well I am putting all my PRs up, which is strictly against the rule I suggested myself. As the purpose was maintaining a clean PR list, and for a few weeks there hasn't been much update from others, I am keeping them all there. Hence, anyone can easily review and suggest changes.
Self-assigned create context. #83 is done.
Hey, I would like to translate this page: Learn React -> Managing State -> Passing Data Deeply with Context
@HabibMollah, Bhai. The page is assigned to you. Now you can start doing translation. I hope this https://github.com/reactjs/bn.react.dev/wiki/Glossary will help you to do a better translation.
Hi! I would like to translate the page Scaling Up with Reducer and Context under Managing State, thanks.
Hi! I would like to translate the page Scaling Up with Reducer and Context under Managing State, thanks.
Assigned
Createcontext done #97 Self assigned forwardref
I would like to translate the page Extracting State Logic into a Reducer
I would like to translate the page
Extracting State Logic into a Reducer
Done
I would like to translate the page Escape Hatches ----> Synchronizing with Effects
I would like to translate the page Escape Hatches ----> Synchronizing with Effects
Done
I am taking over #38. Self assigned it.
Taking over state as a snapshot
Snapshot done. Self assigned memo
Memo done (#117) Taking up createPortal
Thanks to All contributors and Maintainers and Special thanks to @nafistiham Bhai, @moshfiqrony Bhai for doing such an amazing work. We reached 50% of our goal.
Create portal done. Taking Strictmode
Strict mode done. Took over keeping components pure.
@moshfiqrony @ahmmedabir9 @nazir021 @nomandhoni-cs @shakib609 @ahnafyy @nafistiham @nutboltu
Hello Maintainers,
I'd like to translate the useTransition
page.
@moshfiqrony @ahmmedabir9 @nazir021 @nomandhoni-cs @shakib609 @ahnafyy @nafistiham @nutboltu
Hello Maintainers,
I'd like to translate the
useTransition
page.
Hi @mustaquenadim, Thanks for your interest. You are assigned. Please have a look at https://github.com/reactjs/bn.react.dev/issues/32
For New Translators
To translate a page:
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 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:
When PRs are merged, make sure to mark that page as completed like this:
This ensures your translation's progress is tracked correctly at https://translations.react.dev/.
Main Content
To do before releasing as an "official" translation. Please translate these pages first.
Note that each section has an index page, which needs to be translated too.
Learn React
[x] Quick Start ( @anwarhossain1 ) #10
[x] Installation (@nafistiham) #61
[x] Describing the UI (@nafistiham) #62
[ ] Adding Interactivity (@nazir021)
[ ] Managing State ( @ahmmedabir9 )
[x] Escape Hatches (@nafistiham) #21
API Reference
[x]
react
: Hooks ( @SusmoySenGupta ) #39useCallback
(@JaznanOfficial )useContext
(@asif-jalil) #35 #37useDebugValue
( @syum-akhlaque )useDeferredValue
useEffect
( @lifeparticle ) #44useId
(@aleena314)useImperativeHandle
(@nafistiham) #72useInsertionEffect
(@nafistiham) #77useLayoutEffect
(@mustaquenadim)useMemo
(@foridpathan )useReducer
(@Arifur-Rahaman)useRef
(@MostofaNobiTanveer)useState
(@thecodermehedi)useSyncExternalStore
useTransition
(@mustaquenadim) #139[x]
react
: Components (@nafistiham) #58<Fragment> (<>)
(@nafistiham) #57<Profiler>
(@nafistiham) #59<StrictMode>
(@nafistiham)<Suspense>
(@nz-m) #33[x]
react
: APIs (@nafistiham) #60createContext
(@nafistiham) #97forwardRef
(@nafistiham) #105lazy
(@nafistiham) #80memo
(@nafistiham) #117startTransition
(@nafistiham) #79[x]
react-dom
: Components (@nafistiham) #68<div>
)<input>
<option>
(@nafistiham) #67<progress>
(@mahbub-mahi)<select>
<textarea>
[x]
react-dom
: APIs (@nafistiham) #69createPortal
(@nafistiham) #119flushSync
(@nafistiham) #78findDOMNode
hydrate
(@nafistiham) #83render
(@nafistiham) #81unmountComponentAtNode
(@nafistiham) #70[x]
react-dom/client
: Client APIs (@nafistiham) #49createRoot
(@nafistiham) #50hydrateRoot
(@nafistiham) #53[x]
react-dom/server
: Server APIs (@nafistiham) #63renderToNodeStream
(@nafistiham) #64renderToPipeableStream
renderToReadableStream
renderToStaticMarkup
(@nafistiham) #65renderToStaticNodeStream
(@nafistiham) #66renderToString
@habibium #153Navigation and UI
We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.
HomeContent.js
)src/sidebar*.json
)TopNav.tsx
)When You're Ready...
After everything above is translated, add your language to
deployedLanguages
inSeo.tsx
of the original reactjs/react.dev repository.Secondary Content
These API pages should ideally be translated too, but they're less urgent and can be done after the others:
Children
cloneElement
Component
createElement
createFactory
createRef
isValidElement
PureComponent
Optional Content
These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:
Maintainer List
This translation is maintained by:
If you want to become a maintainer, ask them to add you. If the original maintainers are no longer responsive, raise an issue in the main translations repository.