New German Translation Progress

[gaearon]

Maintainer List

• @ChrisB9
• @ph1p
• @miku86

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. Please 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 (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:

• Quick Start (@tesseralis) #12345

When PRs are merged, make sure to mark that page as completed!

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

• Quick Start ( @tburakonat ) Translated quick start #321

  • Tutorial: Tic Tac Toe (@jackblackCH)
  • Thinking in React (@ameetmadan ) Translate thinking-in-react.md #318

• Installation (@krsilas ) Installation #343

  • Start a New React Project (@gu-stav ) just translate the text #323
  • Add React to an Existing Project (@krsilas ) Add react to existing project #342
  • Editor Setup (@zFl4wless ) translate: editor setup #335
  • React Developer Tools (@Dlurak )

• Describing the UI ( @marvhock )

  • Your First Component (@Dlurak )
  • Importing and Exporting Components
  • Writing Markup with JSX
  • JavaScript in JSX with Curly Braces
  • Passing Props to a Component
  • Conditional Rendering
  • Rendering Lists
  • Keeping Components Pure

• Adding Interactivity

  • Responding to Events
  • State: A Component's Memory
  • Render and Commit
  • State as a Snapshot
  • Queueing a Series of State Updates
  • Updating Objects in State
  • Updating Arrays in State

• Managing State

  • Reacting to Input with State
  • Choosing the State Structure
  • Sharing State Between Components
  • Preserving and Resetting State
  • Extracting State Logic into a Reducer
  • Passing Data Deeply with Context
  • Scaling Up with Reducer and Context

• Escape Hatches

  • Referencing Values with Refs
  • Manipulating the DOM with Refs
  • Synchronizing with Effects
  • You Might Not Need an Effect
  • Lifecycle of Reactive Effects
  • Separating Events from Effects
  • Removing Effect Dependencies
  • Reusing Logic with Custom Hooks

API Reference

• react: Hooks (@krsilas ) Translate "Hooks" #325

  • useCallback
  • useContext
  • useDebugValue
  • useDeferredValue
  • useEffect
  • useId
  • useImperativeHandle
  • useInsertionEffect
  • useLayoutEffect
  • useMemo
  • useReducer
  • useRef
  • useState
  • useSyncExternalStore
  • useTransition

• react: Components

  • <Fragment> (<>)
  • <Profiler>
  • <StrictMode>
  • <Suspense>

• react: APIs

  • createContext
  • forwardRef
  • lazy
  • memo
  • startTransition

• react-dom: Components

  • Common (e.g. <div>)
  • <input>
  • <option>
  • <progress>
  • <select>
  • <textarea>

• react-dom: APIs

  • createPortal
  • flushSync
  • findDOMNode
  • hydrate
  • render
  • unmountComponentAtNode

• react-dom/client: Client APIs

  • createRoot
  • hydrateRoot

• react-dom/server: Server APIs

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

• Homepage (currently in HomeContent.js) (@timowenz )
• Sidebars (currently in src/sidebar*.json)
• Top-level navigation (currently in TopNav.tsx)

When You're Ready...

After everything above is translated, add your language to deployedLanguages in Seo.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:

• Legacy React APIs
  • 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:

• Community
• Blog
• Warnings

[ameetmadan]

I would love to help! 👍🏼 I would start with https://de.react.dev/learn/thinking-in-react

[ChrisB9]

Thank you @ameetmadan, I added you

[jackblackCH]

I start to contribute with: Tutorial: Tic Tac Toe

[ChrisB9]

@jackblackCH please check with @TheFireCircle in #290 whether you and him can merge your efforts

[jackblackCH]

Oh, does it even make sense? I would rather do something new. I checked the list above and did not see @TheFireCircle's name next to TicTacToe. Can you update the list with the pages that are in progress?

@jackblackCH please check with @TheFireCircle in #290 whether you and him can merge your efforts

[ChrisB9]

I added you to that list to spearhead this. That tutorial is just a lot of changes and I didnt really want his past effort go entirely to waste without including him.

[gu-stav]

I can start with "Installation > Start a New React Project".

[gu-stav]

Quick question because it was a big problem with the German Gatsby translations at the time: do we already know how to translate "you"?

Example:

If you want to build a new app or a new website fully with React, we recommend picking one of the React-powered frameworks popular in the community.

Would it be:

1. Passive: Um eine neue App oder Website mit React zu bauen, empfehlen wir eines der populären React-basierten Frameworks der Community zu verwenden.

2. Active: Wenn du eine App oder Website mit React bauen willst, empfehlen wir eines der populären React-basierten Frameworks der Community zu verwenden.

Also: do you think we might need a list of words which we do not want to translate (e.g. Community)?

[ChrisB9]

@gu-stav I'll add you

The latter part, there already is a glossary: #10 If you feel like words are missing there, just comment and we can add it to the list

Regarding active/passive du. I personally prefer the passive one, as it does sound more documentation-like. But the active is more in-line with the english version. How about you try it out both ways for a couple sentences, and then we decide the best approach when seeing the results
cc: @ph1p

[gu-stav]

@ChrisB9 Thanks - I missed the Glossary 🙏🏼

Active/ Passive: I would prefer the passive too - active "du" always sounds a bit awkward and too close I think. From my experience, this is something that should be decided early on because otherwise you'd end up with a mix. If everyone agrees I'd suggest to start with passive and see if that feels to distant.

[ameetmadan]

Can we add these 2 points about the glossary and the active/passive "Du" to @gaearon's README? Makes it easier to have all the information in one place.

[ChrisB9]

Sure I can add them to the list, but they are already pinned issues right next to this one. I think the pinned issues is a much easier place than a wall of text

[gaearon]

@ChrisB9 @ph1p @miku86

Can you confirm whether the maintainer list is up-to-date, and whether you'd be able to steer and maintain this translation? I'd like to get https://github.com/reactjs/translations.react.dev/blob/main/langs/de.json reflect the current list. Thank you!

[ph1p]

I am still maintaining (: I do not know about the others

[krsilas]

I would be interested to help in the reference section and start with the general introduction to hooks.

[gaearon]

@ph1p Alright, I'll leave the current list as is, but if you don't hear from other maintainers for some period of time, please send a PR to trim down the list to who's active.

[ChrisB9]

@gaearon I am still there, too, but not as active as @ph1p

[TheFireCircle]

I added you to that list to spearhead this. That tutorial is just a lot of changes and I didnt really want his past effort go entirely to waste without including him.

Hi, there are a lot of differences indeed. @jackblackCH can probably recycle a bunch of common things. Sadly, the effort which went into the last translation is obsolete now. But I can understand that @jackblackCH wants to start over.

[marvhock]

Hi, I would like to take the following:

• Describing the UI (the index page of that section).
• Describing the UI -> Your First Component.

[ChrisB9]

@krsilas added you
@marvhock added you, but just one at a time, trying to prevent stale translation processes

[tburakonat]

Hi I would like to translate the Quick Start page!

[miku86]

@ChrisB9 @ph1p @miku86

Can you confirm whether the maintainer list is up-to-date, and whether you'd be able to steer and maintain this translation? I'd like to get https://github.com/reactjs/translations.react.dev/blob/main/langs/de.json reflect the current list. Thank you!

I'm not that much into React anymore, but I'm open to help to discuss pull requests, language-wise.

[krsilas]

I can do "Add React to an Existing Project" next.

[ChrisB9]

Sounds good, I'll add you

[ThomasSpornraft]

"Add React to an Existing Project" is already done. I thought i am assigned to the whole "Installation" section. Sorry for the confusion
I am almost done, think one "Deep Dive" section to go and then read through again.
just commited my latest state

Installation - done
Start a New React Project - done
Add React to an Existing Project - done
Editor Setup - done
React Developer Tools - untouched

[zFl4wless]

I would like to translate Editor Setup page

[Dlurak]

I would like to translate React Developer Tools

[Dlurak]

I would also want to translate Your First Component

[Dlurak]

Is there a reason Using TypeScript isn't in the list?

[ChrisB9]

Is there a reason Using TypeScript isn't in the list?

Probably because the todo list might be out of date

[timowenz]

Would like to translate the landing page if no one has already done that.

[ChrisB9]

@timowenz go ahead, currently no one is working on anything so feel free 👍