Tradução da documentação para pt-br (Translation Progress)

[eduardomoroni]

A nova documentação do React está no AR. Já criaram um issue sobre o assunto em reactjs/react.dev#4135 e uma discussão #553

Como contribuir

Revisando Pull Requests

uma maneira de contribuir é revisar algum PR que esteja aberto, conferindo se a tradução faz sentido e é entendível.

Traduzindo

Escolha uma das páginas abaixo que esta disponível (ou seja, ninguém está traduzindo), crie um fork deste repositório, traduza a página no seu fork e manda um Pull request para a comunidade revisar e mergear.

Páginas para serem traduzidas

Por favor faça um comentário para atualizarmos essa tabela a medida que prosseguirmos na tradução, colocaremos o seu nome de usuário(a) do github na frente da página que você pretende traduzir

Conteúdo principal

Para fazer antes de lançar como uma tradução "oficial". Por favor, traduza estas páginas primeiro.

Observe que cada seção possui uma página de índice, que também precisa ser traduzida.

Guia de Estilo Universal

• Leia nosso GLOSSARY

Learn React

• Quick Start (@alexandredev3) Tradução da página Quick Start #754

  • Tutorial: Tic Tac Toe (@TarsiSurdi) docs(pt-br): translated tutorial-tic-tac-toe.md #686
  • Thinking in React (@NivaldoFarias) Translate thinking-in-react.md to pt-br #862

• Installation (@NivaldoFarias) Tradução da página installation.md #661

  • Start a New React Project (@NivaldoFarias) Tradução da página start-a-new-react-project.md #662
  • Add React to an Existing Project (@revogabe) Translate add-react-to-an-existing-project #659
  • Editor Setup (@volinha) docs(pt-br): translate editor-setup page #656
  • Using Typescript (@rayonnunes) docs(pt-br): translate typescript page #715
  • React Developer Tools (@CaioAugustoo) docs(pt-br): translate developer-tools page #566

• Describing the UI (@natrodrigo) Translation of the describing-the-ui page #660

  • Your First Component (@alexandredev3) Translate your-first-component page #669
  • Importing and Exporting Components (@tiagobarros01) Translate Importing and Exporting Components page #658
  • Writing Markup with JSX (@volinha) docs(pt-br): translate writing-markup-with-jsx page #657
  • JavaScript in JSX with Curly Braces (@roccomaniscalco) Translate javascript-in-jsx-with-curly-braces.md #674
  • Passing Props to a Component (@TarsiSurdi) docs(pt-br): translated passing-props-to-a-component.md #676
  • Conditional Rendering (@VitorGultzgoff) docs(pt-br): translate conditional-rendering #692
  • Rendering Lists (@TarsiSurdi) Translated 'Rendering Lists' page #670
  • Keeping Components Pure (@buirkan)

• Adding Interactivity (@lucasgbr)

  • Responding to Events (@alexandredev3) Translates responding-to-events page #684
  • State: A Component's Memory (@TarsiSurdi) Translated "State: A Component's Memory" page #671
  • Render and Commit (@tiagobarros01) Translate the render-and-commit page #665
  • State as a Snapshot (@NivaldoFarias) Tradução da página state-as-a-snapshot.md  #690
  • Queueing a Series of State Updates (@augustodg2)
  • Updating Objects in State (@Egpereira) Translate updating-objects-in-state.md #679
  • Updating Arrays in State (@junagao)

• Managing State

  • Reacting to Input with State (@vinicius77) fix(reacting-to-input-with-state) #683
  • Choosing the State Structure (@NivaldoFarias) Tradução da página choosing-the-state-structure.md #688
  • Sharing State Between Components (@sergiotcnolivre) Translated "Sharing State Between Components" page #673
  • Preserving and Resetting State (@VitorGultzgoff)
  • Extracting State Logic into a Reducer
  • Passing Data Deeply with Context (@terciogarcia)
  • Scaling Up with Reducer and Context

• Escape Hatches (@jotaRenan) translate escape-hatches.md to pt-BR #664

  • Referencing Values with Refs (@thelucfer) docs(pt-br): translate 'referencing values with ref' #707
  • Manipulating the DOM with Refs (@gustavospriebe)
  • Synchronizing with Effects (@pedrowindisch)
  • You Might Not Need an Effect (@augustodg2) docs(pt-br): Translate you-might-not-need-an-effect.md #675
  • Lifecycle of Reactive Effects (@jotaRenan)
  • Separating Events from Effects (@alexandredev3)
  • Removing Effect Dependencies
  • Reusing Logic with Custom Hooks (@Guribeiro) Docs/translate reusing logic with custom hooks #695

Blog

• Introducing react.dev (@Lucasfog) docs(pt-br): translate introducing-react-dev page #720

API Reference

• react: Hooks (@vitoroberto) docs(pt-br): translate react-hooks page #708

  • useCallback (@glauberbrack)
  • useContext (@glauberbrack)
  • useDebugValue (@joaooliveiradev)
  • useDeferredValue (@joaooliveiradev)
  • useEffect (@renato-bohler) Initial useEffect translation #682
  • useId (@tiagobarros01) Translate the useId page #697
  • useImperativeHandle (@tiagobarros01) docs(pt-br): translate useImperativeHandle page  #727
  • useInsertionEffect (@GabrielleEmanoela)
  • useLayoutEffect(@Duduzera1997) docs(pt-br): translation of useLayoutEffect hook 🪝 #718
  • useMemo (@TMendes-lucca)
  • useReducer (@TMendes-lucca)
  • useRef (@Duduzera1997)
  • useState (@soutovnc)
  • useSyncExternalStore (@bdsqqq)
  • useTransition (@GabrielleEmanoela) docs(pt-br): translate useTransition page.  #722

• react: Components (@vitoroberto) docs(pt-br): translate react-components page #701

  • <Fragment> (<>) (@kevinCubas) Translate Fragment.md #680
  • <Profiler> (@alexandredev3) Tradução da Página <Profiler> #758
  • <StrictMode>
  • <Suspense> (@tiagobarros01)

• react: APIs (@devlulcas) docs(pt-br): translate react-apis and createContext page #667

  • createContext (@devlulcas) docs(pt-br): translate react-apis and createContext page #667
  • forwardRef
  • lazy (@matheuscaldas1)
  • memo
  • startTransition (@DaveSimoes) startTransition Translate #749

• react-dom: Components (@felipefreitag)

  • Common (e.g. <div>)
  • <input>
  • <option> (@veri-mm) docs(pt-br): translate option page #687
  • <progress> (@felipefreitag) docs(pt-br): translated progress.md #678
  • <select>
  • <textarea>

• react-dom: APIs (@gustavochermout) docs(pt-br): translate reactdom page #636

  • createPortal (@renaldodev)
  • flushSync (@tiagobarros01)
  • findDOMNode
  • hydrate
  • render
  • unmountComponentAtNode

• react-dom/client: Client APIs @odemur

  • createRoot
  • hydrateRoot

• react-dom/server: Server APIs (@MarceloSpessoto) Translates react-dom/server page. #728

  • renderToNodeStream
  • renderToPipeableStream
  • renderToReadableStream
  • renderToStaticMarkup
  • renderToStaticNodeStream
  • renderToString

Navigation e UI

Sugerimos deixar a maior parte da tradução da IU para o final. Planejamos fazer algumas alterações invasivas no layout e nos componentes da pasta do site, portanto, adiar isso até que sua tradução esteja quase concluída facilitaria a mesclagem das alterações de nosso lado mais tarde. Pode fazer sentido traduzir a página inicial logo no início, mas deixar o resto para depois. À medida que as páginas individuais são traduzidas, você pode alterar os títulos das páginas nos arquivos correspondentes da barra lateral. Por fim, ao traduzir a navegação, certifique-se de testar os layouts para desktop e dispositivos móveis.

• Homepage (currently in HomeContent.js) (@jhonmike) Translate React website Home page #655
• Sidebars (currently in src/sidebar*.json) (@emersonbroga) Tradução das Sidebar #663
• Top-level navigation (currently in TopNav.tsx)

Quando você estiver pronto...

Depois que tudo acima for traduzido, adicione seu idioma a deployedLanguages em Seo.tsx do repositório original reactjs/react.dev.

Conteúdo Secundário

O ideal é que essas páginas da API também sejam traduzidas, mas são menos urgentes e podem ser feitas depois das outras:

• Legacy React APIs
  • Children
  • cloneElement
  • Component
  • createElement
  • createFactory
  • createRef
  • isValidElement
  • PureComponent

Conteúdo opcional

Estes não são os principais destinos de tradução, mas se você quiser fazê-los, sinta-se à vontade para expandir a lista para incluir suas subpáginas:

• Community
• Blog
  • Introducing react.dev (@Lucasfog) docs(pt-br): translate introducing-react-dev page #720
• Warnings

[jwandekoken]

Opa. Como posso contribuir com a tradução? (newcomer, sry xD)
Nos organizamos por aqui mesmo, ou temos uma tabela do que já está sendo feito ou algo do tipo?

[eduardomoroni]

Show de bola @jwandekoken , eu atualizei o meu post ali em cima. Basicamente escolhe uma página, traduz e manda um PR.
O que eu faço no verdade é, eu uso uma ferramenta de traduçao, Deepl por exemplo, traduzo a página usando a ferramenta. Depois eu vou lendo os dois e corrigindo o tradutor.
Eu acho mais rápido e fácil, mas você pode traduzir você mesmo do zero também.

[jwandekoken]

learn - @jwandekoken

[walerya]

Olá! Tenho português nativo e, além disso, sou graduada em língua portuguesa, estou estudando TW e gostaria de contribuir com a tradução.

[jwandekoken]

@Waleryaa, escolha uma das páginas e mete bala, o @eduardomoroni mencionou sobre o processo. Caso tenha alguma dúvida ou dificuldade de como fazer, posso te auxiliar (no processo de forkar o repo, baixar, trabalhar no arquivo e subir o PR). Qualquer coisa, só falar!

[walerya]

@jwandekoken Toda ajuda é bem-vinda, até porque esse será meu primeiro projeto aqui no GitHub. Obrigada pela disposição.

[walerya]

Vou fazer "meet-the-team.md". Não sei como colocar na planilha.

[eduardomoroni]

Uma outra grande ajuda @Waleryaa seria dar uma olhada nos Pull Requests ja aberto e revisar. Certifique-se de dar uma revisao "formal", ou seja, enviar uma revisao atraves da aba 'files changed'. Assim a gente ja sabe quais podem ser mergeado.

[walerya]

Obrigada, @eduardomoroni! Farei isso.

[walerya]

Oie! Estou procurando uma nova task para fazer (aproveitando que estou de férias hahaha) e notei que algumas já foram feitas, mas não estão marcadas. É isso mesmo?