Open jakubdrozdek opened 2 years ago
I will take Conditional rendering
@lukbar48 do you do something with Rendering Lists
?
@jakubdrozdek I can take Keeping Components Pure
. Could you assign it to me?
Ok, as @lukbar48 mentioned below, assign also Rendering Lists
to me please.
@lukbar48 do you do something with
Rendering Lists
?
no, take it
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:
Thank you so much for your cooperation!
Hey @gaearon , I'll take a look at this soon and try to update our translations for the new docs. Thanks for resolving all conflicts. I saw how big and complex they were. I'm glad you did this for us 😅
Ah this wasn't me, that's all @rickhanlonii's doing :)
I've updated this issue's TODO list to the current template.
Hey, I could pick up the "Start a New React Project"
Hi @jakubdrozdek, I would like to contribute a bit. I can start with useCallback
.
PR for useCallback
is ready. I would like to start with useEffect
now.
I would like to translate "Start a New React Project" section.
I would like to take "Rendering Lists" from "Describing the UI".
I would like to translate "Add React to an Existing Project" page.
@jakubdrozdek, I would like to. take now Keeping Components Pure .
Two PRs already wait for for next comments or approval ;)
I would like to take Render and Commit page - need something light now ;)
Can I pick up Add react to an existing project page?
@wizarddos I was doing that. It has been pushed already.
@tomaszwysocki Oh, all right
New Site Translation Progress
Maintainer List
Retired maintainers
Preview
https://pl.react.dev/
Original issue
This issue was based on: https://github.com/reactjs/reactjs.org/issues/4135
How to translate
If you want to help with translation, please leave a comment in this issue and write the name of the page you would like to translate. One of the repo maintainers will add your GitHub nickname next to the page to "make a reservation".
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 (@jakubdrozdek) https://github.com/reactjs/pl.react.dev/pull/335
[ ] Installation
[x] Describing the UI (@jakubdrozdek) #340
[ ] Adding Interactivity
[x] Managing State
[ ] Escape Hatches
API Reference
[x]
react
: HooksuseCallback
(@dawidowski) #423useContext
useDebugValue
useDeferredValue
useEffect
(@dawidowski) #431useId
useImperativeHandle
useInsertionEffect
useLayoutEffect
useMemo
useReducer
useRef
useState
(@jakubdrozdek) https://github.com/reactjs/pl.react.dev/pull/341useSyncExternalStore
useTransition
[x]
react
: Components<Fragment> (<>)
<Profiler>
<StrictMode>
<Suspense>
[x]
react
: APIscreateContext
forwardRef
lazy
memo
startTransition
[ ]
react-dom
: Components<div>
)<input>
<option>
<progress>
<select>
<textarea>
[ ]
react-dom
: APIscreatePortal
flushSync
findDOMNode
hydrate
render
unmountComponentAtNode
[ ]
react-dom/client
: Client APIscreateRoot
hydrateRoot
[ ]
react-dom/server
: Server APIsrenderToNodeStream
renderToPipeableStream
renderToReadableStream
renderToStaticMarkup
renderToStaticNodeStream
renderToString
Navigation 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: