reactjs / pt-pt.reactjs.org Goto Github PK

@tesseralis @telmogoncalves @fjoshuajr
Regarding external links, when no pt-PT is available, but pt-BR is available with a decent translation. Which one do you prefer to link? pt-BR or EN?

In my opinion, if someone is reading the portuguese version of the documents, will prefer reading external links in portuguese (brazil) rather than english.

Example:
en-US: https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript
or
pt-BR: https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/A_re-introduction_to_JavaScript

In addition to a translated Universal Style Guide.

We need a proper glossary of terms (translatable and non-translatable)

Thoughts?

I think we should clean up merged branches to keep the repository easy to browse.

Thoughts?

Abordagem

Estamos a usar uma abordagem informal para traduzir a documentação de React. Exemplos:

✅	❌
Experimenta usar [...]	Experimente usar [...]
Tu podes preferir [...]	Você pode preferir [...]

---

Termos a usar ao traduzir a documentação

Inglês	❌	✅
React	Reagir	React
link	link	hiperligação
step by step	passo-a-passo	passo a passo
tags	etiquetas	tags
script	roteiro	script
Overview	Overview	Visão Geral
JavaScript	Javascript	JavaScript
JavaScript library	biblioteca JavaScript	biblioteca de JavaScript
node	node	nó (node)
Hello World	Hello World	Olá Mundo
CDN	o CDN	a CDN
Deprecated	Deprecado	Descontinuado
Escape hatch	Porta de salvação	Escapatória

Maintainer List

• @telmogoncalves
• @fjoshuajr
• @jbarradas

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 any more, let the maintainers know so they can assign the page to someone else.

And please join us in Slack (https://rt-slack-invite.herokuapp.com), we have dedicated channels for each translation team. You might seek help there, either with translation processes or suggestions of words/sentences you might have been struggling with.

For Maintainers

When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:

• Home Page (@tesseralis) #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 (@nelsonmfinda)
• Tutorial

Basics

• Hello World (@jbarradas) #6
• Introducing JSX
• Rendering Elements (@fjoshuajr) #14
• Components and Props (@fjoshuajr) #17
• State and Lifecycle (@antonio-rodrigues)
• Handling Events (@fjoshuajr) #47
• Conditional Rendering
• Lists and Keys (@flowck)
• Forms
• Lifting State Up
• Composition vs Inheritance (@fjoshuajr) #46
• Thinking in React

API Reference

• React
• React.Component
• ReactDOM (@jbarradas) #13
• ReactDOMServer (@fjoshuajr) #7
• DOM Elements
• SyntheticEvent
• Test Utilities
• Shallow Renderer
• Test Renderer (@fjoshuajr) #21
• JS Environment Requirements (@fjoshuajr) #16
• Glossary

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 (@reinaldosimoes) #55
• docs/nav.yml (@reinaldosimoes) #53

Next Steps

These are the next most important translations, ordered by importance:

Installation

• Getting Started (@telmogoncalves) #3
• Add React to a Website
• Create a New React App
• CDN Links (@telmogoncalves) #11

Hooks

Everyone is hooked on hooks! People are really excited about these, and it would be great for them to be translated.

• Introducing Hooks
• Hooks at a Glance
• Using the State Hook
• Using the Effect Hook
• Rules of Hooks
• Building Your Own Hooks
• Hooks API Reference
• Hooks FAQ

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
• invalid-aria-prop
• invalid-hook-call-warning
• legacy-factories
• refs-must-have-owner
• special-props
• unknown-prop

Advanced Guides

• Accessibility (@xiCO2k) #62
• Code-Splitting (@reinaldosimoes) #52
• Context
• Error Boundaries
• Forwarding Refs
• Fragments
• Higher-Order Components
• Integrating with Other Libraries
• JSX In Depth
• Optimizing Performance
• Portals
• React Without ES6
• React Without JSX
• Reconciliation
• Refs and the DOM
• Render Props
• Static Type Checking
• Strict Mode
• Typechecking With PropTypes
• Uncontrolled Components
• Web Components

FAQ

• APIs and AJAX (@fjoshuajr) #40
• Babel, JSX, and Build Steps (@fjoshuajr) #12
• Passing Functions to Components (@fjoshuajr) #41
• Component State (@fjoshuajr) #43
• Styling and CSS (@luisdiogo2071317) #25
• File Structure (@fjoshuajr) #44
• Versioning Policy (@fjoshuajr) #45
• Virtual DOM and Internals (@fjoshuajr) #42

Contributing

Priority: Low

• How to Contribute
• Codebase Overview
• Implementation Notes
• Design Principles

Components

Components in src/components that have some text in them.

• CodeEditor (@fjoshuajr) #39
• CodeExample (@fjoshuajr) #39
• ErrorDecoder (@fjoshuajr) #5
• LayoutFooter (@fjoshuajr) #39
• LayoutHeader (@fjoshuajr) #39
• MarkdownPage (@fjoshuajr) #39

Additional Translations

These are not the primary translation targets.

• Blog
• Community