From b3d23c5348f147b7edad32810cec4c0131ce34fd Mon Sep 17 00:00:00 2001 From: = <=> Date: Thu, 28 Feb 2019 22:19:59 -0300 Subject: [PATCH 01/14] translate how-to-contribute page --- content/docs/how-to-contribute.md | 182 +++++++++++++++--------------- 1 file changed, 90 insertions(+), 92 deletions(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index b45a0b050..d64f22ab3 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -1,6 +1,6 @@ --- id: how-to-contribute -title: How to Contribute +title: Como contribuir layout: contributing permalink: docs/how-to-contribute.html next: codebase-overview.html @@ -9,121 +9,121 @@ redirect_from: - "tips/introduction.html" --- -React is one of Facebook's first open source projects that is both under very active development and is also being used to ship code to everybody on [facebook.com](https://www.facebook.com). We're still working out the kinks to make contributing to this project as easy and transparent as possible, but we're not quite there yet. Hopefully this document makes the process for contributing clear and answers some questions that you may have. +React � um dos primeiros projetos de c�digo aberto do Facebook que est� sendo desenvolvido muito ativamente, al�m de ser usado para entregar c�digo para todos em [facebook.com](https://www.facebook.com). N�s ainda estamos trabalhando para tornar esse projeto mais transparente e f�cil poss�vel, mas ainda n�o est�mos l�. Esperamos que essa documenta��o torne esse processo de contribui��o mais clara e responda algumas perguntas que voc� possa ter. -### [Code of Conduct](https://code.facebook.com/codeofconduct) {#code-of-conduct} +### [C�digo de Conduta](https://code.facebook.com/codeofconduct) {#code-of-conduct} -Facebook has adopted a Code of Conduct that we expect project participants to adhere to. Please read [the full text](https://code.facebook.com/codeofconduct) so that you can understand what actions will and will not be tolerated. +O Facebook adotou um c�digo de contuda que esperamos que todos os participantes desse projeto adotem. Por favor, [leia o texto completo](https://code.facebook.com/codeofconduct) para que voc� possa entender quais a��es ser�o ou n�o toleradas. -### Open Development {#open-development} +### Desenvolvimento Aberto {#open-development} -All work on React happens directly on [GitHub](https://github.com/facebook/react). Both core team members and external contributors send pull requests which go through the same review process. +Todo trabalho no React acontece diretamente no [GitHub](https://github.com/facebook/react). Tanto membros do ***Core Team*** quanto contribuidores externos devem enviar ***pull requests*** que v�o passar pelo mesmo processo de revis�o. -### Branch Organization {#branch-organization} +### Organiza��o de ***branches*** {#branch-organization} -We will do our best to keep the [`master` branch](https://github.com/facebook/react/tree/master) in good shape, with tests passing at all times. But in order to move fast, we will make API changes that your application might not be compatible with. We recommend that you use [the latest stable version of React](/downloads.html). +N�s buscaremos fazer o nosso melhor para manter [branch `master`](https://github.com/facebook/react/tree/master) organizada, com testes passando todas as vezes. Mas para garantir que seremos r�pidos, n�s faremos mudan�as na API nas quais suas aplica��es podem n�o ser compat�veis. N�s recomendamos que voc� use [a vers�o est�vel do React](/downloads.html). -If you send a pull request, please do it against the `master` branch. We maintain stable branches for major versions separately but we don't accept pull requests to them directly. Instead, we cherry-pick non-breaking changes from master to the latest stable major version. +Se voc� enviar uma ***pull request***, por favor fa�a contra a branch `master`. N�s mantemos ***branches*** est�veis para vers�es maiores separadamente, mas n�o aceitamos ***pull requests*** para elas diretamente. Ao inv�s disso, n�s fazemos ***cherry-pick*** de mudan�as que n�o quebrem o c�digo da `master` para a �ltima vers�o mais est�vel. -### Semantic Versioning {#semantic-versioning} +### Versionamento Sem�ntico {#semantic-versioning} -React follows [semantic versioning](http://semver.org/). We release patch versions for bugfixes, minor versions for new features, and major versions for any breaking changes. When we make breaking changes, we also introduce deprecation warnings in a minor version so that our users learn about the upcoming changes and migrate their code in advance. +O Reat segue o [versionamento sem�ntico](http://semver.org/). Buscar lan�ar vers�es de ***patch*** para corre��es de bugs, vers�es secund�rias (minor version) para novos recursos e vers�es principais (major version) para qualquer altera��o de quebra. Quando fazemos altera��es significativas, tamb�m introduzimos alguns avisos de descontinuidade em uma vers�o secund�ria para que nossos usu�rios tenham conhecimento sobre as pr�ximas altera��es e migrem seu c�digo com anteced�ncia. -We tag every pull request with a label marking whether the change should go in the next [patch](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-patch), [minor](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-minor), or a [major](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-major) version. We release new patch versions every few weeks, minor versions every few months, and major versions one or two times a year. +N�s marcamos com ***tags*** qualquer ***pull request*** com um marcador que indica se a altera��o deve ir para o pr�ximo [patch](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-patch), [vers�o secund�ria (minor version)](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-minor) ou em uma [vers�o principal (major version)](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-major). N�s lan�amos novas vers�es de ***patch*** a cada poucas semanas, vers�es secund�rios a cada poucos meses e vers�es principais uma ou duas vezes por ano. -Every significant change is documented in the [changelog file](https://github.com/facebook/react/blob/master/CHANGELOG.md). +Toda mudan�a significativa � documentada na [***changelog***](https://github.com/facebook/react/blob/master/CHANGELOG.md). ### Bugs {#bugs} -#### Where to Find Known Issues {#where-to-find-known-issues} +#### Onde encontrar problemas conhecidos {#where-to-find-known-issues} -We are using [GitHub Issues](https://github.com/facebook/react/issues) for our public bugs. We keep a close eye on this and try to make it clear when we have an internal fix in progress. Before filing a new task, try to make sure your problem doesn't already exist. +N�s estamos utilizando as [GitHub Issues](https://github.com/facebook/react/issues) para nossas p�ginas p�blicas. N�s vamos ficar de olho e tentar manter claro quando estamos trabalhando internamente na corre��o de algum bug. Antes de preencher uma nova tarefa, verifique se o problema j� existe. -#### Reporting New Issues {#reporting-new-issues} +#### Relatando novos problemas {#reporting-new-issues} -The best way to get your bug fixed is to provide a reduced test case. This [JSFiddle template](https://jsfiddle.net/Luktwrdm/) is a great starting point. +A melhor maneira de corrigir o problema � fornecer um caso de teste reduzido. Este [template no JSFiddle](https://jsfiddle.net/Luktwrdm/) � um excelente ponto de partida. -#### Security Bugs {#security-bugs} +#### Bugs de seguran�a {#security-bugs} -Facebook has a [bounty program](https://www.facebook.com/whitehat/) for the safe disclosure of security bugs. With that in mind, please do not file public issues; go through the process outlined on that page. +O Facebook tem um [programa de recompensas](https://www.facebook.com/whitehat/) para a divulga��o segura de bugs de seguran�a. Com isso em mente, n�o reporte esses problemas de forma p�blica; Percorra o processo descrito nessa p�gina. -### How to Get in Touch {#how-to-get-in-touch} +### Como entrar em contato {#how-to-get-in-touch} * IRC: [#reactjs on freenode](https://webchat.freenode.net/?channels=reactjs) -* Discussion forum: [discuss.reactjs.org](https://discuss.reactjs.org/) +* F�rum de Discuss�o: [discuss.reactjs.org](https://discuss.reactjs.org/) -There is also [an active community of React users on the Discord chat platform](http://www.reactiflux.com/) in case you need help with React. +H� tamb�m uma comunidade ativa de usu�rios do React na plataforma no [Discord](http://www.reactiflux.com/) caso voc� precise de ajuda. -### Proposing a Change {#proposing-a-change} +### Propondo uma altera��o {#proposing-a-change} -If you intend to change the public API, or make any non-trivial changes to the implementation, we recommend [filing an issue](https://github.com/facebook/react/issues/new). This lets us reach an agreement on your proposal before you put significant effort into it. +Se voc� pretende alterar a API p�blica ou fazer altera��es n�o triviais na implementa��o, recomendamos [abrir uma ***issue***](https://github.com/facebook/react/issues/new). Isso nos permite chegar a um acordo sobre sua proposta antes de colocar um esfor�o significativo nela. -If you're only fixing a bug, it's fine to submit a pull request right away but we still recommend to file an issue detailing what you're fixing. This is helpful in case we don't accept that specific fix but want to keep track of the issue. +Se voc� est� apenas corrigindo um bug, n�o tem problema em enviar uma ***pull request*** diretamente, mas ainda sim recomendamos abrir uma ***issue*** com detalhes sobre o que voc� est� corrigindo. Isso � �til caso n�o aceitemos essa corre��o espec�fica, mas queremos acompanhar o problema. -### Your First Pull Request {#your-first-pull-request} +### Sua primeira ***Pull Request*** {#your-first-pull-request} -Working on your first Pull Request? You can learn how from this free video series: +Trabalhando em sua primera ***Pull Request***. Voc� pode aprender como desta s�rie de v�deos gratuitos: -**[How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)** +**[Como contribuir para um projeto de c�digo aberto no GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)** -To help you get your feet wet and get you familiar with our contribution process, we have a list of **[good first issues](https://github.com/facebook/react/issues?q=is:open+is:issue+label:"good+first+issue")** that contain bugs that have a relatively limited scope. This is a great place to get started. +Para ajudar voc� a se familiarizar com o nosso processo de contribui��o, temos uma lista de [boas primeiras ***issues***](https://github.com/facebook/react/issues?q=is:open+is:issue+label:"good+first+issue") que cont�m erros que t�m um escopo relativamente limitado. Este � um �timo lugar para come�ar. -If you decide to fix an issue, please be sure to check the comment thread in case somebody is already working on a fix. If nobody is working on it at the moment, please leave a comment stating that you intend to work on it so other people don't accidentally duplicate your effort. +Se voc� decidir corrigir um bug, por favor, verifique o t�pico do coment�rio caso algu�m j� esteja trabalhando em uma corre��o. Se ningu�m estiver trabalhando no momento, por favor deixe um coment�rio dizendo que voc� pretende trabalhar nele para que outras pessoas n�o dupliquem sem querer seu esfor�o. -If somebody claims an issue but doesn't follow up for more than two weeks, it's fine to take it over but you should still leave a comment. +Se algu�m assumir uma ***issue***, mas n�o fizer o acompanhamento por mais de duas semanas, n�o h� problema em voc� assumir, mas mesmo assim voc� ainda deve deixar um coment�rio. -### Sending a Pull Request {#sending-a-pull-request} +### Enviando uma ***Pull Request*** {#sending-a-pull-request} -The core team is monitoring for pull requests. We will review your pull request and either merge it, request changes to it, or close it with an explanation. For API changes we may need to fix our internal uses at Facebook.com, which could cause some delay. We'll do our best to provide updates and feedback throughout the process. -**Before submitting a pull request,** please make sure the following is done: +O Core Team est� monitorando as ***pull requests***. Analisaremos seu envio e fazermos o ***merge***, solicitaremos altera��es ou podemos fech�-la com uma explica��o plaus�vel. Para altera��es de API, podemos precisar corrigir nossos usos internos no Facebook.com, o que pode causar algum atraso. Faremos o nosso melhor para fornecer atualiza��es e feedback durante todo o processo. -1. Fork [the repository](https://github.com/facebook/react) and create your branch from `master`. -2. Run `yarn` in the repository root. -3. If you've fixed a bug or added code that should be tested, add tests! -4. Ensure the test suite passes (`yarn test`). Tip: `yarn test --watch TestName` is helpful in development. -5. Run `yarn test-prod` to test in the production environment. It supports the same options as `yarn test`. -6. If you need a debugger, run `yarn debug-test --watch TestName`, open `chrome://inspect`, and press "Inspect". -7. Format your code with [prettier](https://github.com/prettier/prettier) (`yarn prettier`). -8. Make sure your code lints (`yarn lint`). Tip: `yarn linc` to only check changed files. -9. Run the [Flow](https://flowtype.org/) typechecks (`yarn flow`). -10. If you haven't already, complete the CLA. +**Antes de enviar a sua pull request,** certifique-se de ter feito os seguintes passos: -### Contributor License Agreement (CLA) {#contributor-license-agreement-cla} +1. Fala fork do [reposit�rio oficial](https://github.com/facebook/react) and criou sua branch da `master`. +2. Execute `yarn` no reposit�rio ra�z. +3. Se voc� corrigiu um bug ou um c�digo adicionado que deve ser testado, adicione testes! +4. Certifique-se de que a su�te de teste passe (`yarn test`). Dica: `yarn test --watch TestName` � �til no desenvolvimento. +5. Execute `yarn test-prod` para testar no ambiente de produ��o. Suporta as mesmas op��es que `yarn test`. +6. Se voc� precisar de um depurador, execute `yarn debug-test --watch TestName`, abra `chrome://inspect`e aperte em "Inspecionar". +7. Formate seu c�digo com [prettier](https://github.com/prettier/prettier) (`yarn prettier`). +8. Certifique-se de que seus c�digos foram verificados com linters (`yarn lint`). Dica: `yarn linc` verifica somente os arquivos alterados. +9. Rode o [Flow](https://flowtype.org/) para typechecks (`yarn flow`). +10. Se ainda n�o fez, preencha o CLA. -In order to accept your pull request, we need you to submit a CLA. You only need to do this once, so if you've done this for another Facebook open source project, you're good to go. If you are submitting a pull request for the first time, just let us know that you have completed the CLA and we can cross-check with your GitHub username. +### Licen�a de Acordo de Contribuidor (***Contributor License Agreement*** - CLA) {#contributor-license-agreement-cla} -**[Complete your CLA here.](https://code.facebook.com/cla)** +Para aceitar sua ***pull request***, precisamos que voc� envie um CLA. Voc� s� precisa fazer isso uma vez, ent�o se voc� fez isso para outro projeto de c�digo aberto do Facebook, voc� est� pronto para continuar. Se voc� estiver enviando uma ***pull request*** pela primeira vez, nos informe que voc� concluiu o CLA e ent�o podemos fazer uma verifica��o cruzada com seu GitHub -### Contribution Prerequisites {#contribution-prerequisites} +**[Preencha sua CLA aqui.](https://code.facebook.com/cla)** -* You have [Node](https://nodejs.org) installed at v8.0.0+ and [Yarn](https://yarnpkg.com/en/) at v1.2.0+. -* You have `gcc` installed or are comfortable installing a compiler if needed. Some of our dependencies may require a compilation step. On OS X, the Xcode Command Line Tools will cover this. On Ubuntu, `apt-get install build-essential` will install the required packages. Similar commands should work on other Linux distros. Windows will require some additional steps, see the [`node-gyp` installation instructions](https://github.com/nodejs/node-gyp#installation) for details. -* You are familiar with Git. +### Pr�-requisitos de contribui��o {#contribution-prerequisites} -### Development Workflow {#development-workflow} +* Possuir o [Node](https://nodejs.org) instalado na vers�o v8.0.0+ e [Yarn](https://yarnpkg.com/en/) na vers�o v1.2.0+. +* Voc� deve ter o `gcc` instalado ou est� confort�vel em instalar um compilador, se necess�rio. Algumas de nossas depend�ncias podem exigir uma etapa de compila��o. No OS X, as Ferramentas de Linha de Comando do Xcode cobrir�o isso. No Ubuntu, `apt-get install build-essential` instalar� os pacotes requeridos. Comandos semelhantes devem funcionar em outras distribui��es Linux. O Windows ir� requerer alguns passos adicionais, veja as instru��es de instala��o do [node-gyp](https://github.com/nodejs/node-gyp#installation) para detalhes. +* Voc� deve ser familiarizado com o Git. -After cloning React, run `yarn` to fetch its dependencies. -Then, you can run several commands: +### Fluxo de Trabalho de Desenvolvimento {#development-workflow} -* `yarn lint` checks the code style. -* `yarn linc` is like `yarn lint` but faster because it only checks files that differ in your branch. -* `yarn test` runs the complete test suite. -* `yarn test --watch` runs an interactive test watcher. -* `yarn test ` runs tests with matching filenames. -* `yarn test-prod` runs tests in the production environment. It supports all the same options as `yarn test`. -* `yarn debug-test` is just like `yarn test` but with a debugger. Open `chrome://inspect` and press "Inspect". -* `yarn flow` runs the [Flow](https://flowtype.org/) typechecks. -* `yarn build` creates a `build` folder with all the packages. -* `yarn build react/index,react-dom/index --type=UMD` creates UMD builds of just React and ReactDOM. +Depois de clonar o React, execute `yarn` para buscar suas depend�ncias.E nt�o, voc� pode executar v�rios comandos: -We recommend running `yarn test` (or its variations above) to make sure you don't introduce any regressions as you work on your change. However it can be handy to try your build of React in a real project. +* `yarn lint` verifica o estilo de c�digo. +* `yarn linc` funciona como o `yarn lint` mas �w mais r�pido porque verifica apenas os arquivos que diferem na sua ***branch***. +* `yarn test` executa o conjunto de testes completo. +* `yarn test --watch` executa um observador de testes interativo. +* `yarn test ` executa testes com nomes de arquivos correspondentes. +* `yarn test-prod` executa testes no ambiente de produ��o. Suporta todas as mesmas op��es que o `yarn test`. +* `yarn debug-test` � como `yarn test` mas com um depurador. Abra `chrome://inspect` e clique em "Inspecionar". +* `yarn flow` executa o typecheck do [Flow](https://flowtype.org/) . +* `yarn build` cria uma pasta `build` com todos os pacotes. +* `yarn build react/index,react-dom/index --type=UMD` cria compila��es UMD somente com o React e ReactDOM. -First, run `yarn build`. This will produce pre-built bundles in `build` folder, as well as prepare npm packages inside `build/packages`. +Recomendamos executar o `yarn test` (ou suas varia��es acima) para garantir que voc� n�o introduza nenhuma regress�o enquanto trabalha na sua mudan�a. No entanto, pode ser �til testar sua vers�o do React em um projeto real. -The easiest way to try your changes is to run `yarn build react/index,react-dom/index --type=UMD` and then open `fixtures/packaging/babel-standalone/dev.html`. This file already uses `react.development.js` from the `build` folder so it will pick up your changes. +Primeiro, execute `yarn build`. Isto ir� produzir pacotes pr�-constru�dos na pasta `build`, bem como ir� preparar pacotes npm dentro da pasta `build/packages`. -If you want to try your changes in your existing React project, you may copy `build/dist/react.development.js`, `build/dist/react-dom.development.js`, or any other build products into your app and use them instead of the stable version. If your project uses React from npm, you may delete `react` and `react-dom` in its dependencies and use `yarn link` to point them to your local `build` folder: +A maneira mais f�cil de testar suas altera��es � rodar `yarn build react/index,react-dom/index --type=UMD` e depois abrir `fixtures/packaging/babel-standalone/dev.html`. Este arquivo j� usa o `react.development.js` a partir da pasta `build` para que ele possa pegar suas altera��es. + +Se voc� quiser testar suas altera��es em seu projeto React j� existente, voc� pode copiar `build/dist/react.development.js`, `build/dist/react-dom.development.js` ou qualquer outro build em seu aplicativo e us�-los em vez da vers�o est�vel. Se o seu projeto usa o React do npm, voc� pode excluir `react` e` react-dom` em suas depend�ncias e usar `yarn link` para apont�-los para sua pasta` build` local: ```sh cd ~/path_to_your_react_clone/build/node_modules/react @@ -134,45 +134,43 @@ cd /path/to/your/project yarn link react react-dom ``` -Every time you run `yarn build` in the React folder, the updated versions will appear in your project's `node_modules`. You can then rebuild your project to try your changes. +Toda vez que voc� executar `yarn build` na pasta React, as vers�es atualizadas aparecer�o no` node_modules` do seu projeto. Voc� pode ent�o reconstruir seu projeto para testar suas altera��es. -We still require that your pull request contains unit tests for any new functionality. This way we can ensure that we don't break your code in the future. +Ainda exigimos que sua ***pull request*** contenha testes de unidade para qualquer nova funcionalidade. Dessa forma, podemos garantir que n�o quebremos seu c�digo no futuro. -### Style Guide {#style-guide} +### Guia de estilo {#style-guide} -We use an automatic code formatter called [Prettier](https://prettier.io/). -Run `yarn prettier` after making any changes to the code. +Usamos um formatador de c�digo autom�tico chamado [Prettier](https://prettier.io/). Execute o `yarn prettier` depois de fazer qualquer altera��o no seu c�digo. -Then, our linter will catch most issues that may exist in your code. -You can check the status of your code styling by simply running `yarn linc`. +Ent�o, nosso linter ir� capturar a maioria dos problemas que possam existir em seu c�digo. Voc� pode verificar o status do seu estilo de c�digo simplesmente executando `yarn linc`. -However, there are still some styles that the linter cannot pick up. If you are unsure about something, looking at [Airbnb's Style Guide](https://github.com/airbnb/javascript) will guide you in the right direction. +No entanto, ainda existem alguns estilos que o linter n�o consegue captar. Se voc� n�o tem certeza sobre alguma coisa, veja o [Guia de Estilos do Airbnb](https://github.com/airbnb/javascript) para te direcionar no caminho certo. -### Introductory Video {#introductory-video} +### V�deo introdut�rio {#introductory-video} -You may be interested in watching [this short video](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 mins) which gives an introduction on how to contribute to React. +Voc� pode estar interessado em assistir [este pequeno v�deo](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos), que apresenta uma introdu��o sobre como contribuir para o React. -#### Video highlights: {#video-highlights} -- [4:12](https://youtu.be/wUpPsEcGsg8?t=4m12s) - Building and testing React locally -- [6:07](https://youtu.be/wUpPsEcGsg8?t=6m7s) - Creating and sending pull requests -- [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizing code +#### Destaques no v�deo: {#video-highlights} +- [4:12](https://youtu.be/wUpPsEcGsg8?t=4m12s) - Construindo e testando Reagir localmente +- [6:07](https://youtu.be/wUpPsEcGsg8?t=6m7s) - Criando e enviando ***pull requests*** +- [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizando c�digo - [14:43](https://youtu.be/wUpPsEcGsg8?t=14m43s) - React npm registry -- [19:15](https://youtu.be/wUpPsEcGsg8?t=19m15s) - Adding new React features +- [19:15](https://youtu.be/wUpPsEcGsg8?t=19m15s) - Adicionando novos recursos do React -For a realistic overview of what it _feels_ like to contribute to React for the first time, check out [this entertaining ReactNYC talk](https://www.youtube.com/watch?v=GWCcZ6fnpn4). +Para obter uma vis�o geral realista do que � o sentimento de contribuir para o React pela primeira vez, confira [essa palestra interessante no ReactNYC](https://www.youtube.com/watch?v=GWCcZ6fnpn4). -### Request for Comments (RFC) {#request-for-comments-rfc} +### Pedido de Coment�rios (Request for Comments - RFC) {#request-for-comments-rfc} -Many changes, including bug fixes and documentation improvements can be implemented and reviewed via the normal GitHub pull request workflow. +Muitas altera��es, incluindo corre��es de bugs e melhorias na documenta��o, podem ser implementadas e revisadas por meio do fluxo de trabalho normal de ***pull requests*** do GitHub. -Some changes though are "substantial", and we ask that these be put through a bit of a design process and produce a consensus among the React core team. +Algumas mudan�as, entretanto, s�o "substanciais", e pedimos que estas sejam submetidas a um pequeno processo de design e produzam um consenso entre o Core Team do React. -The "RFC" (request for comments) process is intended to provide a consistent and controlled path for new features to enter the project. You can contribute by visiting the [rfcs repository](https://github.com/reactjs/rfcs). +O processo "RFC" (pedido de coment�rios) destina-se a fornecer um caminho consistente e controlado para que novos recursos entrem no projeto. Voc� pode contribuir visitando o reposit�rio [rfcs](https://github.com/reactjs/rfcs). -### License {#license} +### Licen�a {#license} -By contributing to React, you agree that your contributions will be licensed under its MIT license. +Ao contribuir com o React, voc� concorda que suas contribui��es ser�o licenciadas sob sua licen�a do MIT. -### What Next? {#what-next} +### O que vem a seguir? {#what-next} -Read the [next section](/docs/codebase-overview.html) to learn how the codebase is organized. +Leia a [pr�xima se��o](/docs/codebase-overview.html) para saber como a base de c�digo � organizada. From 7ed0a36eb03f8a94146893073844188f3121395b Mon Sep 17 00:00:00 2001 From: = <=> Date: Thu, 28 Feb 2019 22:31:04 -0300 Subject: [PATCH 02/14] fix charset --- content/docs/how-to-contribute.md | 136 +++++++++++++++--------------- 1 file changed, 68 insertions(+), 68 deletions(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index d64f22ab3..35faf9bec 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -9,121 +9,121 @@ redirect_from: - "tips/introduction.html" --- -React � um dos primeiros projetos de c�digo aberto do Facebook que est� sendo desenvolvido muito ativamente, al�m de ser usado para entregar c�digo para todos em [facebook.com](https://www.facebook.com). N�s ainda estamos trabalhando para tornar esse projeto mais transparente e f�cil poss�vel, mas ainda n�o est�mos l�. Esperamos que essa documenta��o torne esse processo de contribui��o mais clara e responda algumas perguntas que voc� possa ter. +React é um dos primeiros projetos de código aberto do Facebook que está sendo desenvolvido muito ativamente, além de ser usado para entregar código para todos em [facebook.com](https://www.facebook.com). Nós ainda estamos trabalhando para tornar esse projeto mais transparente e fácil possível, mas ainda não estámos lá. Esperamos que essa documentação torne esse processo de contribuição mais clara e responda algumas perguntas que você possa ter. -### [C�digo de Conduta](https://code.facebook.com/codeofconduct) {#code-of-conduct} +### [Código de Conduta](https://code.facebook.com/codeofconduct) {#code-of-conduct} -O Facebook adotou um c�digo de contuda que esperamos que todos os participantes desse projeto adotem. Por favor, [leia o texto completo](https://code.facebook.com/codeofconduct) para que voc� possa entender quais a��es ser�o ou n�o toleradas. +O Facebook adotou um código de contuda que esperamos que todos os participantes desse projeto adotem. Por favor, [leia o texto completo](https://code.facebook.com/codeofconduct) para que você possa entender quais ações serão ou não toleradas. ### Desenvolvimento Aberto {#open-development} -Todo trabalho no React acontece diretamente no [GitHub](https://github.com/facebook/react). Tanto membros do ***Core Team*** quanto contribuidores externos devem enviar ***pull requests*** que v�o passar pelo mesmo processo de revis�o. +Todo trabalho no React acontece diretamente no [GitHub](https://github.com/facebook/react). Tanto membros do ***Core Team*** quanto contribuidores externos devem enviar ***pull requests*** que vão passar pelo mesmo processo de revisão. -### Organiza��o de ***branches*** {#branch-organization} +### Organização de ***branches*** {#branch-organization} -N�s buscaremos fazer o nosso melhor para manter [branch `master`](https://github.com/facebook/react/tree/master) organizada, com testes passando todas as vezes. Mas para garantir que seremos r�pidos, n�s faremos mudan�as na API nas quais suas aplica��es podem n�o ser compat�veis. N�s recomendamos que voc� use [a vers�o est�vel do React](/downloads.html). +Nós buscaremos fazer o nosso melhor para manter [branch `master`](https://github.com/facebook/react/tree/master) organizada, com testes passando todas as vezes. Mas para garantir que seremos rápidos, nós faremos mudanças na API nas quais suas aplicações podem não ser compatíveis. Nós recomendamos que você use [a versão estável do React](/downloads.html). -Se voc� enviar uma ***pull request***, por favor fa�a contra a branch `master`. N�s mantemos ***branches*** est�veis para vers�es maiores separadamente, mas n�o aceitamos ***pull requests*** para elas diretamente. Ao inv�s disso, n�s fazemos ***cherry-pick*** de mudan�as que n�o quebrem o c�digo da `master` para a �ltima vers�o mais est�vel. +Se você enviar uma ***pull request***, por favor faça contra a branch `master`. Nós mantemos ***branches*** estáveis para versões maiores separadamente, mas não aceitamos ***pull requests*** para elas diretamente. Ao invés disso, nós fazemos ***cherry-pick*** de mudanças que não quebrem o código da `master` para a última versão mais estável. -### Versionamento Sem�ntico {#semantic-versioning} +### Versionamento Semântico {#semantic-versioning} -O Reat segue o [versionamento sem�ntico](http://semver.org/). Buscar lan�ar vers�es de ***patch*** para corre��es de bugs, vers�es secund�rias (minor version) para novos recursos e vers�es principais (major version) para qualquer altera��o de quebra. Quando fazemos altera��es significativas, tamb�m introduzimos alguns avisos de descontinuidade em uma vers�o secund�ria para que nossos usu�rios tenham conhecimento sobre as pr�ximas altera��es e migrem seu c�digo com anteced�ncia. +O Reat segue o [versionamento semântico](http://semver.org/). Buscar lançar versões de ***patch*** para correções de bugs, versões secundárias (minor version) para novos recursos e versões principais (major version) para qualquer alteração de quebra. Quando fazemos alterações significativas, também introduzimos alguns avisos de descontinuidade em uma versão secundária para que nossos usuários tenham conhecimento sobre as próximas alterações e migrem seu código com antecedência. -N�s marcamos com ***tags*** qualquer ***pull request*** com um marcador que indica se a altera��o deve ir para o pr�ximo [patch](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-patch), [vers�o secund�ria (minor version)](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-minor) ou em uma [vers�o principal (major version)](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-major). N�s lan�amos novas vers�es de ***patch*** a cada poucas semanas, vers�es secund�rios a cada poucos meses e vers�es principais uma ou duas vezes por ano. +Nós marcamos com ***tags*** qualquer ***pull request*** com um marcador que indica se a alteração deve ir para o próximo [patch](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-patch), [versão secundária (minor version)](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-minor) ou em uma [versão principal (major version)](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-major). Nós lançamos novas versões de ***patch*** a cada poucas semanas, versões secundários a cada poucos meses e versões principais uma ou duas vezes por ano. -Toda mudan�a significativa � documentada na [***changelog***](https://github.com/facebook/react/blob/master/CHANGELOG.md). +Toda mudança significativa é documentada na [***changelog***](https://github.com/facebook/react/blob/master/CHANGELOG.md). ### Bugs {#bugs} #### Onde encontrar problemas conhecidos {#where-to-find-known-issues} -N�s estamos utilizando as [GitHub Issues](https://github.com/facebook/react/issues) para nossas p�ginas p�blicas. N�s vamos ficar de olho e tentar manter claro quando estamos trabalhando internamente na corre��o de algum bug. Antes de preencher uma nova tarefa, verifique se o problema j� existe. +Nós estamos utilizando as [GitHub Issues](https://github.com/facebook/react/issues) para nossas páginas públicas. Nós vamos ficar de olho e tentar manter claro quando estamos trabalhando internamente na correção de algum bug. Antes de preencher uma nova tarefa, verifique se o problema já existe. #### Relatando novos problemas {#reporting-new-issues} -A melhor maneira de corrigir o problema � fornecer um caso de teste reduzido. Este [template no JSFiddle](https://jsfiddle.net/Luktwrdm/) � um excelente ponto de partida. +A melhor maneira de corrigir o problema é fornecer um caso de teste reduzido. Este [template no JSFiddle](https://jsfiddle.net/Luktwrdm/) é um excelente ponto de partida. -#### Bugs de seguran�a {#security-bugs} +#### Bugs de segurança {#security-bugs} -O Facebook tem um [programa de recompensas](https://www.facebook.com/whitehat/) para a divulga��o segura de bugs de seguran�a. Com isso em mente, n�o reporte esses problemas de forma p�blica; Percorra o processo descrito nessa p�gina. +O Facebook tem um [programa de recompensas](https://www.facebook.com/whitehat/) para a divulgação segura de bugs de segurança. Com isso em mente, não reporte esses problemas de forma pública; Percorra o processo descrito nessa página. ### Como entrar em contato {#how-to-get-in-touch} * IRC: [#reactjs on freenode](https://webchat.freenode.net/?channels=reactjs) -* F�rum de Discuss�o: [discuss.reactjs.org](https://discuss.reactjs.org/) +* Fórum de Discussão: [discuss.reactjs.org](https://discuss.reactjs.org/) -H� tamb�m uma comunidade ativa de usu�rios do React na plataforma no [Discord](http://www.reactiflux.com/) caso voc� precise de ajuda. +Há também uma comunidade ativa de usuários do React na plataforma no [Discord](http://www.reactiflux.com/) caso você precise de ajuda. -### Propondo uma altera��o {#proposing-a-change} +### Propondo uma alteração {#proposing-a-change} -Se voc� pretende alterar a API p�blica ou fazer altera��es n�o triviais na implementa��o, recomendamos [abrir uma ***issue***](https://github.com/facebook/react/issues/new). Isso nos permite chegar a um acordo sobre sua proposta antes de colocar um esfor�o significativo nela. +Se você pretende alterar a API pública ou fazer alterações não triviais na implementação, recomendamos [abrir uma ***issue***](https://github.com/facebook/react/issues/new). Isso nos permite chegar a um acordo sobre sua proposta antes de colocar um esforço significativo nela. -Se voc� est� apenas corrigindo um bug, n�o tem problema em enviar uma ***pull request*** diretamente, mas ainda sim recomendamos abrir uma ***issue*** com detalhes sobre o que voc� est� corrigindo. Isso � �til caso n�o aceitemos essa corre��o espec�fica, mas queremos acompanhar o problema. +Se você está apenas corrigindo um bug, não tem problema em enviar uma ***pull request*** diretamente, mas ainda sim recomendamos abrir uma ***issue*** com detalhes sobre o que você está corrigindo. Isso é útil caso não aceitemos essa correção específica, mas queremos acompanhar o problema. ### Sua primeira ***Pull Request*** {#your-first-pull-request} -Trabalhando em sua primera ***Pull Request***. Voc� pode aprender como desta s�rie de v�deos gratuitos: +Trabalhando em sua primera ***Pull Request***. Você pode aprender como desta série de vídeos gratuitos: -**[Como contribuir para um projeto de c�digo aberto no GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)** +**[Como contribuir para um projeto de código aberto no GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)** -Para ajudar voc� a se familiarizar com o nosso processo de contribui��o, temos uma lista de [boas primeiras ***issues***](https://github.com/facebook/react/issues?q=is:open+is:issue+label:"good+first+issue") que cont�m erros que t�m um escopo relativamente limitado. Este � um �timo lugar para come�ar. +Para ajudar você a se familiarizar com o nosso processo de contribuição, temos uma lista de [boas primeiras ***issues***](https://github.com/facebook/react/issues?q=is:open+is:issue+label:"good+first+issue") que contém erros que têm um escopo relativamente limitado. Este é um ótimo lugar para começar. -Se voc� decidir corrigir um bug, por favor, verifique o t�pico do coment�rio caso algu�m j� esteja trabalhando em uma corre��o. Se ningu�m estiver trabalhando no momento, por favor deixe um coment�rio dizendo que voc� pretende trabalhar nele para que outras pessoas n�o dupliquem sem querer seu esfor�o. +Se você decidir corrigir um bug, por favor, verifique o tópico do comentário caso alguém já esteja trabalhando em uma correção. Se ninguém estiver trabalhando no momento, por favor deixe um comentário dizendo que você pretende trabalhar nele para que outras pessoas não dupliquem sem querer seu esforço. -Se algu�m assumir uma ***issue***, mas n�o fizer o acompanhamento por mais de duas semanas, n�o h� problema em voc� assumir, mas mesmo assim voc� ainda deve deixar um coment�rio. +Se alguém assumir uma ***issue***, mas não fizer o acompanhamento por mais de duas semanas, não há problema em você assumir, mas mesmo assim você ainda deve deixar um comentário. ### Enviando uma ***Pull Request*** {#sending-a-pull-request} -O Core Team est� monitorando as ***pull requests***. Analisaremos seu envio e fazermos o ***merge***, solicitaremos altera��es ou podemos fech�-la com uma explica��o plaus�vel. Para altera��es de API, podemos precisar corrigir nossos usos internos no Facebook.com, o que pode causar algum atraso. Faremos o nosso melhor para fornecer atualiza��es e feedback durante todo o processo. +O Core Team está monitorando as ***pull requests***. Analisaremos seu envio e fazermos o ***merge***, solicitaremos alterações ou podemos fechá-la com uma explicação plausível. Para alterações de API, podemos precisar corrigir nossos usos internos no Facebook.com, o que pode causar algum atraso. Faremos o nosso melhor para fornecer atualizações e feedback durante todo o processo. **Antes de enviar a sua pull request,** certifique-se de ter feito os seguintes passos: -1. Fala fork do [reposit�rio oficial](https://github.com/facebook/react) and criou sua branch da `master`. -2. Execute `yarn` no reposit�rio ra�z. -3. Se voc� corrigiu um bug ou um c�digo adicionado que deve ser testado, adicione testes! -4. Certifique-se de que a su�te de teste passe (`yarn test`). Dica: `yarn test --watch TestName` � �til no desenvolvimento. -5. Execute `yarn test-prod` para testar no ambiente de produ��o. Suporta as mesmas op��es que `yarn test`. -6. Se voc� precisar de um depurador, execute `yarn debug-test --watch TestName`, abra `chrome://inspect`e aperte em "Inspecionar". -7. Formate seu c�digo com [prettier](https://github.com/prettier/prettier) (`yarn prettier`). -8. Certifique-se de que seus c�digos foram verificados com linters (`yarn lint`). Dica: `yarn linc` verifica somente os arquivos alterados. +1. Fala fork do [repositório oficial](https://github.com/facebook/react) and criou sua branch da `master`. +2. Execute `yarn` no repositório raíz. +3. Se você corrigiu um bug ou um código adicionado que deve ser testado, adicione testes! +4. Certifique-se de que a suíte de teste passe (`yarn test`). Dica: `yarn test --watch TestName` é útil no desenvolvimento. +5. Execute `yarn test-prod` para testar no ambiente de produção. Suporta as mesmas opções que `yarn test`. +6. Se você precisar de um depurador, execute `yarn debug-test --watch TestName`, abra `chrome://inspect`e aperte em "Inspecionar". +7. Formate seu código com [prettier](https://github.com/prettier/prettier) (`yarn prettier`). +8. Certifique-se de que seus códigos foram verificados com linters (`yarn lint`). Dica: `yarn linc` verifica somente os arquivos alterados. 9. Rode o [Flow](https://flowtype.org/) para typechecks (`yarn flow`). -10. Se ainda n�o fez, preencha o CLA. +10. Se ainda não fez, preencha o CLA. -### Licen�a de Acordo de Contribuidor (***Contributor License Agreement*** - CLA) {#contributor-license-agreement-cla} +### Licença de Acordo de Contribuidor (***Contributor License Agreement*** - CLA) {#contributor-license-agreement-cla} -Para aceitar sua ***pull request***, precisamos que voc� envie um CLA. Voc� s� precisa fazer isso uma vez, ent�o se voc� fez isso para outro projeto de c�digo aberto do Facebook, voc� est� pronto para continuar. Se voc� estiver enviando uma ***pull request*** pela primeira vez, nos informe que voc� concluiu o CLA e ent�o podemos fazer uma verifica��o cruzada com seu GitHub +Para aceitar sua ***pull request***, precisamos que você envie um CLA. Você só precisa fazer isso uma vez, então se você fez isso para outro projeto de código aberto do Facebook, você está pronto para continuar. Se você estiver enviando uma ***pull request*** pela primeira vez, nos informe que você concluiu o CLA e então podemos fazer uma verificação cruzada com seu GitHub **[Preencha sua CLA aqui.](https://code.facebook.com/cla)** -### Pr�-requisitos de contribui��o {#contribution-prerequisites} +### Pré-requisitos de contribuição {#contribution-prerequisites} -* Possuir o [Node](https://nodejs.org) instalado na vers�o v8.0.0+ e [Yarn](https://yarnpkg.com/en/) na vers�o v1.2.0+. -* Voc� deve ter o `gcc` instalado ou est� confort�vel em instalar um compilador, se necess�rio. Algumas de nossas depend�ncias podem exigir uma etapa de compila��o. No OS X, as Ferramentas de Linha de Comando do Xcode cobrir�o isso. No Ubuntu, `apt-get install build-essential` instalar� os pacotes requeridos. Comandos semelhantes devem funcionar em outras distribui��es Linux. O Windows ir� requerer alguns passos adicionais, veja as instru��es de instala��o do [node-gyp](https://github.com/nodejs/node-gyp#installation) para detalhes. -* Voc� deve ser familiarizado com o Git. +* Possuir o [Node](https://nodejs.org) instalado na versão v8.0.0+ e [Yarn](https://yarnpkg.com/en/) na versão v1.2.0+. +* Você deve ter o `gcc` instalado ou está confortável em instalar um compilador, se necessário. Algumas de nossas dependências podem exigir uma etapa de compilação. No OS X, as Ferramentas de Linha de Comando do Xcode cobrirão isso. No Ubuntu, `apt-get install build-essential` instalará os pacotes requeridos. Comandos semelhantes devem funcionar em outras distribuições Linux. O Windows irá requerer alguns passos adicionais, veja as instruções de instalação do [node-gyp](https://github.com/nodejs/node-gyp#installation) para detalhes. +* Você deve ser familiarizado com o Git. ### Fluxo de Trabalho de Desenvolvimento {#development-workflow} -Depois de clonar o React, execute `yarn` para buscar suas depend�ncias.E nt�o, voc� pode executar v�rios comandos: +Depois de clonar o React, execute `yarn` para buscar suas dependências.E ntão, você pode executar vários comandos: -* `yarn lint` verifica o estilo de c�digo. -* `yarn linc` funciona como o `yarn lint` mas �w mais r�pido porque verifica apenas os arquivos que diferem na sua ***branch***. +* `yarn lint` verifica o estilo de código. +* `yarn linc` funciona como o `yarn lint` mas ´w mais rápido porque verifica apenas os arquivos que diferem na sua ***branch***. * `yarn test` executa o conjunto de testes completo. * `yarn test --watch` executa um observador de testes interativo. * `yarn test ` executa testes com nomes de arquivos correspondentes. -* `yarn test-prod` executa testes no ambiente de produ��o. Suporta todas as mesmas op��es que o `yarn test`. -* `yarn debug-test` � como `yarn test` mas com um depurador. Abra `chrome://inspect` e clique em "Inspecionar". +* `yarn test-prod` executa testes no ambiente de produção. Suporta todas as mesmas opções que o `yarn test`. +* `yarn debug-test` é como `yarn test` mas com um depurador. Abra `chrome://inspect` e clique em "Inspecionar". * `yarn flow` executa o typecheck do [Flow](https://flowtype.org/) . * `yarn build` cria uma pasta `build` com todos os pacotes. -* `yarn build react/index,react-dom/index --type=UMD` cria compila��es UMD somente com o React e ReactDOM. +* `yarn build react/index,react-dom/index --type=UMD` cria compilações UMD somente com o React e ReactDOM. -Recomendamos executar o `yarn test` (ou suas varia��es acima) para garantir que voc� n�o introduza nenhuma regress�o enquanto trabalha na sua mudan�a. No entanto, pode ser �til testar sua vers�o do React em um projeto real. +Recomendamos executar o `yarn test` (ou suas variações acima) para garantir que você não introduza nenhuma regressão enquanto trabalha na sua mudança. No entanto, pode ser útil testar sua versão do React em um projeto real. -Primeiro, execute `yarn build`. Isto ir� produzir pacotes pr�-constru�dos na pasta `build`, bem como ir� preparar pacotes npm dentro da pasta `build/packages`. +Primeiro, execute `yarn build`. Isto irá produzir pacotes pré-construídos na pasta `build`, bem como irá preparar pacotes npm dentro da pasta `build/packages`. -A maneira mais f�cil de testar suas altera��es � rodar `yarn build react/index,react-dom/index --type=UMD` e depois abrir `fixtures/packaging/babel-standalone/dev.html`. Este arquivo j� usa o `react.development.js` a partir da pasta `build` para que ele possa pegar suas altera��es. +A maneira mais fácil de testar suas alterações é rodar `yarn build react/index,react-dom/index --type=UMD` e depois abrir `fixtures/packaging/babel-standalone/dev.html`. Este arquivo já usa o `react.development.js` a partir da pasta `build` para que ele possa pegar suas alterações. -Se voc� quiser testar suas altera��es em seu projeto React j� existente, voc� pode copiar `build/dist/react.development.js`, `build/dist/react-dom.development.js` ou qualquer outro build em seu aplicativo e us�-los em vez da vers�o est�vel. Se o seu projeto usa o React do npm, voc� pode excluir `react` e` react-dom` em suas depend�ncias e usar `yarn link` para apont�-los para sua pasta` build` local: +Se você quiser testar suas alterações em seu projeto React já existente, você pode copiar `build/dist/react.development.js`, `build/dist/react-dom.development.js` ou qualquer outro build em seu aplicativo e usá-los em vez da versão estável. Se o seu projeto usa o React do npm, você pode excluir `react` e` react-dom` em suas dependências e usar `yarn link` para apontá-los para sua pasta` build` local: ```sh cd ~/path_to_your_react_clone/build/node_modules/react @@ -134,43 +134,43 @@ cd /path/to/your/project yarn link react react-dom ``` -Toda vez que voc� executar `yarn build` na pasta React, as vers�es atualizadas aparecer�o no` node_modules` do seu projeto. Voc� pode ent�o reconstruir seu projeto para testar suas altera��es. +Toda vez que você executar `yarn build` na pasta React, as versões atualizadas aparecerão no` node_modules` do seu projeto. Você pode então reconstruir seu projeto para testar suas alterações. -Ainda exigimos que sua ***pull request*** contenha testes de unidade para qualquer nova funcionalidade. Dessa forma, podemos garantir que n�o quebremos seu c�digo no futuro. +Ainda exigimos que sua ***pull request*** contenha testes de unidade para qualquer nova funcionalidade. Dessa forma, podemos garantir que não quebremos seu código no futuro. ### Guia de estilo {#style-guide} -Usamos um formatador de c�digo autom�tico chamado [Prettier](https://prettier.io/). Execute o `yarn prettier` depois de fazer qualquer altera��o no seu c�digo. +Usamos um formatador de código automático chamado [Prettier](https://prettier.io/). Execute o `yarn prettier` depois de fazer qualquer alteração no seu código. -Ent�o, nosso linter ir� capturar a maioria dos problemas que possam existir em seu c�digo. Voc� pode verificar o status do seu estilo de c�digo simplesmente executando `yarn linc`. +Então, nosso linter irá capturar a maioria dos problemas que possam existir em seu código. Você pode verificar o status do seu estilo de código simplesmente executando `yarn linc`. -No entanto, ainda existem alguns estilos que o linter n�o consegue captar. Se voc� n�o tem certeza sobre alguma coisa, veja o [Guia de Estilos do Airbnb](https://github.com/airbnb/javascript) para te direcionar no caminho certo. +No entanto, ainda existem alguns estilos que o linter não consegue captar. Se você não tem certeza sobre alguma coisa, veja o [Guia de Estilos do Airbnb](https://github.com/airbnb/javascript) para te direcionar no caminho certo. -### V�deo introdut�rio {#introductory-video} +### Vídeo introdutório {#introductory-video} -Voc� pode estar interessado em assistir [este pequeno v�deo](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos), que apresenta uma introdu��o sobre como contribuir para o React. +Você pode estar interessado em assistir [este pequeno vídeo](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos), que apresenta uma introdução sobre como contribuir para o React. -#### Destaques no v�deo: {#video-highlights} +#### Destaques no vídeo: {#video-highlights} - [4:12](https://youtu.be/wUpPsEcGsg8?t=4m12s) - Construindo e testando Reagir localmente - [6:07](https://youtu.be/wUpPsEcGsg8?t=6m7s) - Criando e enviando ***pull requests*** -- [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizando c�digo +- [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizando código - [14:43](https://youtu.be/wUpPsEcGsg8?t=14m43s) - React npm registry - [19:15](https://youtu.be/wUpPsEcGsg8?t=19m15s) - Adicionando novos recursos do React -Para obter uma vis�o geral realista do que � o sentimento de contribuir para o React pela primeira vez, confira [essa palestra interessante no ReactNYC](https://www.youtube.com/watch?v=GWCcZ6fnpn4). +Para obter uma visão geral realista do que é o sentimento de contribuir para o React pela primeira vez, confira [essa palestra interessante no ReactNYC](https://www.youtube.com/watch?v=GWCcZ6fnpn4). -### Pedido de Coment�rios (Request for Comments - RFC) {#request-for-comments-rfc} +### Pedido de Comentários (Request for Comments - RFC) {#request-for-comments-rfc} -Muitas altera��es, incluindo corre��es de bugs e melhorias na documenta��o, podem ser implementadas e revisadas por meio do fluxo de trabalho normal de ***pull requests*** do GitHub. +Muitas alterações, incluindo correções de bugs e melhorias na documentação, podem ser implementadas e revisadas por meio do fluxo de trabalho normal de ***pull requests*** do GitHub. -Algumas mudan�as, entretanto, s�o "substanciais", e pedimos que estas sejam submetidas a um pequeno processo de design e produzam um consenso entre o Core Team do React. +Algumas mudanças, entretanto, são "substanciais", e pedimos que estas sejam submetidas a um pequeno processo de design e produzam um consenso entre o Core Team do React. -O processo "RFC" (pedido de coment�rios) destina-se a fornecer um caminho consistente e controlado para que novos recursos entrem no projeto. Voc� pode contribuir visitando o reposit�rio [rfcs](https://github.com/reactjs/rfcs). +O processo "RFC" (pedido de comentários) destina-se a fornecer um caminho consistente e controlado para que novos recursos entrem no projeto. Você pode contribuir visitando o repositório [rfcs](https://github.com/reactjs/rfcs). -### Licen�a {#license} +### Licença {#license} -Ao contribuir com o React, voc� concorda que suas contribui��es ser�o licenciadas sob sua licen�a do MIT. +Ao contribuir com o React, você concorda que suas contribuições serão licenciadas sob sua licença do MIT. ### O que vem a seguir? {#what-next} -Leia a [pr�xima se��o](/docs/codebase-overview.html) para saber como a base de c�digo � organizada. +Leia a [próxima seção](/docs/codebase-overview.html) para saber como a base de código é organizada. From 275f21feb21868079cab08138df2e11a2a5d8e13 Mon Sep 17 00:00:00 2001 From: = <=> Date: Fri, 1 Mar 2019 10:54:39 -0300 Subject: [PATCH 03/14] fix typo --- content/docs/how-to-contribute.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 225a1075a..c9e60f4e7 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -9,7 +9,7 @@ redirect_from: - "tips/introduction.html" --- -React é um dos primeiros projetos de código aberto do Facebook que está sendo desenvolvido muito ativamente, além de ser usado para entregar código para todos em [facebook.com](https://www.facebook.com). Nós ainda estamos trabalhando para tornar esse projeto mais transparente e fácil possível, mas ainda não estámos lá. Esperamos que essa documentação torne esse processo de contribuição mais clara e responda algumas perguntas que você possa ter. +React é um dos primeiros projetos de código aberto do Facebook que está sendo desenvolvido muito ativamente, além de ser usado para entregar código para todos em [facebook.com](https://www.facebook.com). Nós ainda estamos trabalhando para tornar esse projeto mais transparente e fácil possível, mas ainda não estamos lá. Esperamos que essa documentação torne esse processo de contribuição mais clara e responda algumas perguntas que você possa ter. ### [Código de Conduta](https://code.facebook.com/codeofconduct) {#code-of-conduct} @@ -62,7 +62,7 @@ Se você está apenas corrigindo um bug, não tem problema em enviar uma ***pull ### Sua primeira ***Pull Request*** {#your-first-pull-request} -Trabalhando em sua primera ***Pull Request***. Você pode aprender como desta série de vídeos gratuitos: +Trabalhando em sua primeira ***Pull Request***. Você pode aprender como desta série de vídeos gratuitos: **[Como contribuir para um projeto de código aberto no GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)** @@ -78,7 +78,7 @@ O Core Team está monitorando as ***pull requests***. Analisaremos seu envio e f **Antes de enviar a sua pull request,** certifique-se de ter feito os seguintes passos: -1. Fala fork do [repositório oficial](https://github.com/facebook/react) and criou sua branch da `master`. +1. Faça fork do [repositório oficial](https://github.com/facebook/react) and criou sua branch da `master`. 2. Execute `yarn` no repositório raíz. 3. Se você corrigiu um bug ou um código adicionado que deve ser testado, adicione testes! 4. Certifique-se de que a suíte de teste passe (`yarn test`). Dica: `yarn test --watch TestName` é útil no desenvolvimento. @@ -103,10 +103,10 @@ Para aceitar sua ***pull request***, precisamos que você envie um CLA. Você s ### Fluxo de Trabalho de Desenvolvimento {#development-workflow} -Depois de clonar o React, execute `yarn` para buscar suas dependências.E ntão, você pode executar vários comandos: +Depois de clonar o React, execute `yarn` para buscar suas dependências. Então, você pode executar vários comandos: * `yarn lint` verifica o estilo de código. -* `yarn linc` funciona como o `yarn lint` mas ´w mais rápido porque verifica apenas os arquivos que diferem na sua ***branch***. +* `yarn linc` funciona como o `yarn lint`, mas é mais rápido porque verifica apenas os arquivos que diferem na sua ***branch***. * `yarn test` executa o conjunto de testes completo. * `yarn test --watch` executa um observador de testes interativo. * `yarn test ` executa testes com nomes de arquivos correspondentes. @@ -122,7 +122,7 @@ Primeiro, execute `yarn build`. Isto irá produzir pacotes pré-construídos na A maneira mais fácil de testar suas alterações é rodar `yarn build react/index,react-dom/index --type=UMD` e depois abrir `fixtures/packaging/babel-standalone/dev.html`. Este arquivo já usa o `react.development.js` a partir da pasta `build` para que ele possa pegar suas alterações. -Se você quiser testar suas alterações em seu projeto React já existente, você pode copiar `build/dist/react.development.js`, `build/dist/react-dom.development.js` ou qualquer outro build em seu aplicativo e usá-los em vez da versão estável. Se o seu projeto usa o React do npm, você pode excluir `react` e` react-dom` em suas dependências e usar `yarn link` para apontá-los para sua pasta` build` local: +Se você quiser testar suas alterações em seu projeto React já existente, você pode copiar `build/dist/react.development.js`, `build/dist/react-dom.development.js` ou qualquer outro build em seu aplicativo e usá-los em vez da versão estável. Se o seu projeto usa o React do npm, você pode excluir `react` e `react-dom` em suas dependências e usar `yarn link` para apontá-los para sua pasta` build` local: ```sh cd ~/path_to_your_react_clone/build/node_modules/react @@ -133,7 +133,7 @@ cd /path/to/your/project yarn link react react-dom ``` -Toda vez que você executar `yarn build` na pasta React, as versões atualizadas aparecerão no` node_modules` do seu projeto. Você pode então reconstruir seu projeto para testar suas alterações. +Toda vez que você executar `yarn build` na pasta React, as versões atualizadas aparecerão no `node_modules` do seu projeto. Você pode então reconstruir seu projeto para testar suas alterações. Ainda exigimos que sua ***pull request*** contenha testes de unidade para qualquer nova funcionalidade. Dessa forma, podemos garantir que não quebremos seu código no futuro. From e73b38a1cf95091343b2c99af4975e2ac08e084d Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:07:36 -0300 Subject: [PATCH 04/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index c9e60f4e7..cf1698abb 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -1,6 +1,6 @@ --- id: how-to-contribute -title: Como contribuir +title: Como Contribuir layout: contributing permalink: docs/how-to-contribute.html next: codebase-overview.html From ae78d751c0cf14e38b86aa46622aa0b1a893fda9 Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:07:51 -0300 Subject: [PATCH 05/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index cf1698abb..5b7fb7737 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -19,7 +19,7 @@ O Facebook adotou um código de contuda que esperamos que todos os participantes Todo trabalho no React acontece diretamente no [GitHub](https://github.com/facebook/react). Tanto membros do ***Core Team*** quanto contribuidores externos devem enviar ***pull requests*** que vão passar pelo mesmo processo de revisão. -### Organização de ***branches*** {#branch-organization} +### Organização de Branches {#branch-organization} Nós buscaremos fazer o nosso melhor para manter [branch `master`](https://github.com/facebook/react/tree/master) organizada, com testes passando todas as vezes. Mas para garantir que seremos rápidos, nós faremos mudanças na API nas quais suas aplicações podem não ser compatíveis. Nós recomendamos que você use [a versão estável do React](/downloads.html). From d5d742416e33773f40a084e2511eb77e3774086c Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:08:02 -0300 Subject: [PATCH 06/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 5b7fb7737..36168169b 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -35,7 +35,7 @@ Toda mudança significativa é documentada na [***changelog***](https://github.c ### Bugs {#bugs} -#### Onde encontrar problemas conhecidos {#where-to-find-known-issues} +#### Onde Encontrar Problemas Conhecidos {#where-to-find-known-issues} Nós estamos utilizando as [GitHub Issues](https://github.com/facebook/react/issues) para nossas páginas públicas. Nós vamos ficar de olho e tentar manter claro quando estamos trabalhando internamente na correção de algum bug. Antes de preencher uma nova tarefa, verifique se o problema já existe. From 1e87f62bda0e69b94c7278c297b793cac15a8222 Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:08:12 -0300 Subject: [PATCH 07/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 36168169b..177bc63b7 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -43,7 +43,7 @@ Nós estamos utilizando as [GitHub Issues](https://github.com/facebook/react/iss A melhor maneira de corrigir o problema é fornecer um caso de teste reduzido. Este [template no JSFiddle](https://jsfiddle.net/Luktwrdm/) é um excelente ponto de partida. -#### Bugs de segurança {#security-bugs} +#### Bugs de Segurança {#security-bugs} O Facebook tem um [programa de recompensas](https://www.facebook.com/whitehat/) para a divulgação segura de bugs de segurança. Com isso em mente, não reporte esses problemas de forma pública; Percorra o processo descrito nessa página. From b066c36af65e14cd7e325b6be14ca518603d96f3 Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:08:23 -0300 Subject: [PATCH 08/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 177bc63b7..c4993f190 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -45,7 +45,7 @@ A melhor maneira de corrigir o problema é fornecer um caso de teste reduzido. E #### Bugs de Segurança {#security-bugs} -O Facebook tem um [programa de recompensas](https://www.facebook.com/whitehat/) para a divulgação segura de bugs de segurança. Com isso em mente, não reporte esses problemas de forma pública; Percorra o processo descrito nessa página. +O Facebook tem um [programa de recompensas](https://www.facebook.com/whitehat/) para a divulgação segura de bugs de segurança. Com isso em mente, não reporte esses problemas de forma pública. Percorra o processo descrito nessa página. ### Como entrar em contato {#how-to-get-in-touch} From 4ca135ab72f8d18b04cd31caf812800261b168b0 Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:08:31 -0300 Subject: [PATCH 09/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index c4993f190..65e9209fd 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -95,7 +95,7 @@ Para aceitar sua ***pull request***, precisamos que você envie um CLA. Você s **[Preencha sua CLA aqui.](https://code.facebook.com/cla)** -### Pré-requisitos de contribuição {#contribution-prerequisites} +### Pré-requisitos de Contribuição {#contribution-prerequisites} * Possuir o [Node](https://nodejs.org) instalado na versão v8.0.0+ e [Yarn](https://yarnpkg.com/en/) na versão v1.2.0+. * Você deve ter o `gcc` instalado ou está confortável em instalar um compilador, se necessário. Algumas de nossas dependências podem exigir uma etapa de compilação. No OS X, as Ferramentas de Linha de Comando do Xcode cobrirão isso. No Ubuntu, `apt-get install build-essential` instalará os pacotes requeridos. Comandos semelhantes devem funcionar em outras distribuições Linux. O Windows irá requerer alguns passos adicionais, veja as instruções de instalação do [node-gyp](https://github.com/nodejs/node-gyp#installation) para detalhes. From e22a1af90d1760671f1f1fdec2eea1df4ed8712c Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:08:39 -0300 Subject: [PATCH 10/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 65e9209fd..407f3071a 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -137,7 +137,7 @@ Toda vez que você executar `yarn build` na pasta React, as versões atualizadas Ainda exigimos que sua ***pull request*** contenha testes de unidade para qualquer nova funcionalidade. Dessa forma, podemos garantir que não quebremos seu código no futuro. -### Guia de estilo {#style-guide} +### Guia de Estilo {#style-guide} Usamos um formatador de código automático chamado [Prettier](https://prettier.io/). Execute o `yarn prettier` depois de fazer qualquer alteração no seu código. From 2ba5255cbd6f2e5ca02969c829c410afee31fd0c Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:08:46 -0300 Subject: [PATCH 11/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 407f3071a..894a094ee 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -145,7 +145,7 @@ Então, nosso linter irá capturar a maioria dos problemas que possam existir em No entanto, ainda existem alguns estilos que o linter não consegue captar. Se você não tem certeza sobre alguma coisa, veja o [Guia de Estilos do Airbnb](https://github.com/airbnb/javascript) para te direcionar no caminho certo. -### Vídeo introdutório {#introductory-video} +### Vídeo Introdutório {#introductory-video} Você pode estar interessado em assistir [este pequeno vídeo](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos), que apresenta uma introdução sobre como contribuir para o React. From fbc0c41728c8be25cf36a10a82cb880463fbf047 Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:09:04 -0300 Subject: [PATCH 12/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 894a094ee..fe48c61ef 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -150,7 +150,7 @@ No entanto, ainda existem alguns estilos que o linter não consegue captar. Se v Você pode estar interessado em assistir [este pequeno vídeo](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos), que apresenta uma introdução sobre como contribuir para o React. #### Destaques no vídeo: {#video-highlights} -- [4:12](https://youtu.be/wUpPsEcGsg8?t=4m12s) - Construindo e testando Reagir localmente +- [4:12](https://youtu.be/wUpPsEcGsg8?t=4m12s) - Construindo e testando o React localmente - [6:07](https://youtu.be/wUpPsEcGsg8?t=6m7s) - Criando e enviando ***pull requests*** - [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizando código - [14:43](https://youtu.be/wUpPsEcGsg8?t=14m43s) - React npm registry From 73dc640cd230a0edcae1ac97350aec2475e7158b Mon Sep 17 00:00:00 2001 From: Glaucia Lemos Date: Sun, 3 Mar 2019 15:09:14 -0300 Subject: [PATCH 13/14] Update content/docs/how-to-contribute.md Co-Authored-By: lhcgoncalves --- content/docs/how-to-contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index fe48c61ef..62cbb1562 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -162,7 +162,7 @@ Para obter uma visão geral realista do que é o sentimento de contribuir para o Muitas alterações, incluindo correções de bugs e melhorias na documentação, podem ser implementadas e revisadas por meio do fluxo de trabalho normal de ***pull requests*** do GitHub. -Algumas mudanças, entretanto, são "substanciais", e pedimos que estas sejam submetidas a um pequeno processo de design e produzam um consenso entre o Core Team do React. +Algumas mudanças, entretanto, são "substanciais" e pedimos que estas sejam submetidas a um pequeno processo de design e produzam um consenso entre o Core Team do React. O processo "RFC" (pedido de comentários) destina-se a fornecer um caminho consistente e controlado para que novos recursos entrem no projeto. Você pode contribuir visitando o repositório [rfcs](https://github.com/reactjs/rfcs). From 5c86b90aca30686df23c11c2fd456ba7aa5faa01 Mon Sep 17 00:00:00 2001 From: = <=> Date: Tue, 5 Mar 2019 13:44:56 -0300 Subject: [PATCH 14/14] change to male speech --- content/docs/how-to-contribute.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 62cbb1562..ef9e34b76 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -23,7 +23,7 @@ Todo trabalho no React acontece diretamente no [GitHub](https://github.com/faceb Nós buscaremos fazer o nosso melhor para manter [branch `master`](https://github.com/facebook/react/tree/master) organizada, com testes passando todas as vezes. Mas para garantir que seremos rápidos, nós faremos mudanças na API nas quais suas aplicações podem não ser compatíveis. Nós recomendamos que você use [a versão estável do React](/downloads.html). -Se você enviar uma ***pull request***, por favor faça contra a branch `master`. Nós mantemos ***branches*** estáveis para versões maiores separadamente, mas não aceitamos ***pull requests*** para elas diretamente. Ao invés disso, nós fazemos ***cherry-pick*** de mudanças que não quebrem o código da `master` para a última versão mais estável. +Se você enviar um ***pull request***, por favor faça contra a branch `master`. Nós mantemos ***branches*** estáveis para versões maiores separadamente, mas não aceitamos ***pull requests*** para elas diretamente. Ao invés disso, nós fazemos ***cherry-pick*** de mudanças que não quebrem o código da `master` para a última versão mais estável. ### Versionamento Semântico {#semantic-versioning} @@ -60,9 +60,9 @@ Se você pretende alterar a API pública ou fazer alterações não triviais na Se você está apenas corrigindo um bug, não tem problema em enviar uma ***pull request*** diretamente, mas ainda sim recomendamos abrir uma ***issue*** com detalhes sobre o que você está corrigindo. Isso é útil caso não aceitemos essa correção específica, mas queremos acompanhar o problema. -### Sua primeira ***Pull Request*** {#your-first-pull-request} +### Seu primeiro ***Pull Request*** {#your-first-pull-request} -Trabalhando em sua primeira ***Pull Request***. Você pode aprender como desta série de vídeos gratuitos: +Trabalhando em seu primeiro ***Pull Request***. Você pode aprender como desta série de vídeos gratuitos: **[Como contribuir para um projeto de código aberto no GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)** @@ -72,11 +72,11 @@ Se você decidir corrigir um bug, por favor, verifique o tópico do comentário Se alguém assumir uma ***issue***, mas não fizer o acompanhamento por mais de duas semanas, não há problema em você assumir, mas mesmo assim você ainda deve deixar um comentário. -### Enviando uma ***Pull Request*** {#sending-a-pull-request} +### Enviando um ***Pull Request*** {#sending-a-pull-request} -O Core Team está monitorando as ***pull requests***. Analisaremos seu envio e fazermos o ***merge***, solicitaremos alterações ou podemos fechá-la com uma explicação plausível. Para alterações de API, podemos precisar corrigir nossos usos internos no Facebook.com, o que pode causar algum atraso. Faremos o nosso melhor para fornecer atualizações e feedback durante todo o processo. +O Core Team está monitorando os ***pull requests***. Analisaremos seu envio e fazermos o ***merge***, solicitaremos alterações ou podemos fechá-la com uma explicação plausível. Para alterações de API, podemos precisar corrigir nossos usos internos no Facebook.com, o que pode causar algum atraso. Faremos o nosso melhor para fornecer atualizações e feedback durante todo o processo. -**Antes de enviar a sua pull request,** certifique-se de ter feito os seguintes passos: +**Antes de enviar o seu pull request,** certifique-se de ter feito os seguintes passos: 1. Faça fork do [repositório oficial](https://github.com/facebook/react) and criou sua branch da `master`. 2. Execute `yarn` no repositório raíz. @@ -91,7 +91,7 @@ O Core Team está monitorando as ***pull requests***. Analisaremos seu envio e f ### Licença de Acordo de Contribuidor (***Contributor License Agreement*** - CLA) {#contributor-license-agreement-cla} -Para aceitar sua ***pull request***, precisamos que você envie um CLA. Você só precisa fazer isso uma vez, então se você fez isso para outro projeto de código aberto do Facebook, você está pronto para continuar. Se você estiver enviando uma ***pull request*** pela primeira vez, nos informe que você concluiu o CLA e então podemos fazer uma verificação cruzada com seu GitHub +Para aceitar seu ***pull request***, precisamos que você envie um CLA. Você só precisa fazer isso uma vez, então se você fez isso para outro projeto de código aberto do Facebook, você está pronto para continuar. Se você estiver enviando um ***pull request*** pela primeira vez, nos informe que você concluiu o CLA e então podemos fazer uma verificação cruzada com seu GitHub **[Preencha sua CLA aqui.](https://code.facebook.com/cla)** @@ -135,7 +135,7 @@ yarn link react react-dom Toda vez que você executar `yarn build` na pasta React, as versões atualizadas aparecerão no `node_modules` do seu projeto. Você pode então reconstruir seu projeto para testar suas alterações. -Ainda exigimos que sua ***pull request*** contenha testes de unidade para qualquer nova funcionalidade. Dessa forma, podemos garantir que não quebremos seu código no futuro. +Ainda exigimos que seu ***pull request*** contenha testes de unidade para qualquer nova funcionalidade. Dessa forma, podemos garantir que não quebremos seu código no futuro. ### Guia de Estilo {#style-guide}