From 51ca8977ae37048e34fc761b0a1746dcd9deab5d Mon Sep 17 00:00:00 2001 From: maudel Date: Fri, 15 Feb 2019 14:16:21 -0400 Subject: [PATCH 1/4] translating how to contribute section. --- content/docs/how-to-contribute.md | 195 +++++++++++++++--------------- content/docs/nav.yml | 2 +- 2 files changed, 101 insertions(+), 96 deletions(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index b45a0b050..082453524 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: ¿Cómo Contribuir? layout: contributing permalink: docs/how-to-contribute.html next: codebase-overview.html @@ -9,170 +9,175 @@ 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 es uno de los primeros proyectos de código abierto de Facebook que se encuentran bajo una fase de desarrollo activa y también se utiliza para entregar productos de sofware a todos en [facebook.com](https://www.facebook.com). Todavía estamos trabajando en los problemas para hacer que la contribución a este proyecto sea lo más fácil y transparente posible, pero aún no hemos llegado a ese punto. Esperamos que este documento haga que el proceso de contribución sea claro y responda algunas preguntas que pueda tener. -### [Code of Conduct](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. +### [Codigo de Conducta](https://code.facebook.com/codeofconduct) {#code-of-conduct} -### Open Development {#open-development} +Facebook ha adoptado un Código de conducta que esperamos que los participantes del proyecto cumplan. Lea [el texto completo](https://code.facebook.com/codeofconduct) para que pueda comprender qué acciones serán o no toleradas. -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. +### Desarrollo Abierto {#open-development} -### Branch Organization {#branch-organization} +Todo el trabajo en React sucede directamente en [GitHub](https://github.com/facebook/react). Tanto los miembros del equipo central como los colaboradores externos envían pull requests que pasan por el mismo proceso de revisión. -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). +### Organizacion de Ramas {#branch-organization} + +Haremos todo lo posible para mantener la [rama `maestra`](https://github.com/facebook/react/tree/master) en buen estado, con pruebas que pasen todo el tiempo. Pero para avanzar rápidamente, realizaremos cambios en la API con los que tu aplicación podría no ser compatible. Recomendamos que uses [la última versión estable de React](/downloads.html). + +Si envías un pull request, hazlo contra la rama `master`. Mantenemos ramas estables para las versiones principales por separado, pero no aceptamos pull requests directamente a ellas. En su lugar, seleccionamos los cambios que no se rompen de la versión principal a la última versión estable. 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. -### Semantic Versioning {#semantic-versioning} +### Versionamiento 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. +React sigue [el versionamiento semántico](http://semver.org/). Lanzamos versiones de parches para correcciones de errores, versiones secundarias para nuevas funciones y versiones principales para cualquier cambio importante. Cuando hacemos cambios importantes, también introducimos advertencias de descontinuación en una versión menor para que nuestros usuarios conozcan los próximos cambios y migren su código de antemano. -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. +Etiquetamos cada pull request con un rótulo que indica si el cambio debería ir en la siguiente version [parche](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-patch), [menor](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-minor), o [mayor](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-major). Lanzamos nuevas versiones de parches cada pocas semanas, versiones menores cada pocos meses y versiones mayores una o dos veces al año. -Every significant change is documented in the [changelog file](https://github.com/facebook/react/blob/master/CHANGELOG.md). +Cada cambio significativo se documenta en el [archivo de registro de cambios](https://github.com/facebook/react/blob/master/CHANGELOG.md). ### Bugs {#bugs} -#### Where to Find Known Issues {#where-to-find-known-issues} +#### Donde Encontrar Problemas Conocidos {#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. +Estamos utilizando [GitHub Issues](https://github.com/facebook/react/issues) para nuestros bugs. Mantenemos una estrecha vigilancia sobre esto y tratamos de avisar cuando tenemos una solución interna en curso. Antes de reportar un nuevo problema, asegúrese de que su bug no haya sido reportado. -#### Reporting New Issues {#reporting-new-issues} +#### Reportando Nuevos 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. +La mejor manera de solucionar su bug es proporcionar un caso de prueba reducido. Esta [plantilla JSFiddle](https://jsfiddle.net/Luktwrdm/) es un gran punto de partida. -#### Security Bugs {#security-bugs} +#### Bugs de Seguridad {#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. +Facebook tiene un [programa de recompensas](https://www.facebook.com/whitehat/) para la divulgación segura de errores de seguridad. Con esto en mente, por favor no envie problemas públicos. Siga el proceso descrito en esa página. -### How to Get in Touch {#how-to-get-in-touch} +### Como entrar en contacto {#how-to-get-in-touch} -* IRC: [#reactjs on freenode](https://webchat.freenode.net/?channels=reactjs) -* Discussion forum: [discuss.reactjs.org](https://discuss.reactjs.org/) +* IRC: [#reactjs en freenode](https://webchat.freenode.net/?channels=reactjs) +* Foro de discusión: [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. +También hay [una comunidad activa de usuarios de React en la plataforma de chat Discord](http://www.reactiflux.com/) en caso de que necesite ayuda con React. -### Proposing a Change {#proposing-a-change} +### Proponiendo un Cambio {#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. +Si tiene la intención de cambiar la API pública o realizar cambios no triviales en la implementación, recomendamos [presentar el problema](https://github.com/facebook/react/issues/new). Esto nos permite llegar a un acuerdo sobre su propuesta antes que le ponga un gran esfuerzo. -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. +Si solo está solucionando un error, está bien enviar un pull request de inmediato, pero le recomendamos que presente el problema que detalle que es lo que está solucionando. Esto es útil en caso de que no aceptemos esa solución en particular, pero de todas maneras queremos hacer el seguimiento del problema. -### Your First Pull Request {#your-first-pull-request} +### Tu Primer Pull Request {#your-first-pull-request} -Working on your first Pull Request? You can learn how from this free video series: +¿Trabajando en tu primer Pull Request? Puedes aprender como en esta serie de videos gratis: -**[How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)** +**[Cómo contribuir a un proyecto de código abierto en 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 ayudarlo a empaparse los pies y familiarizarse con nuestro proceso de contribución, tenemos una lista de **[Buenas Primeras Tareas](https://github.com/facebook/react/issues?q=is:open+is:issue+label:"good+first+issue")** que contienen errores que tienen un alcance relativamente limitado. Este es un gran lugar para empezar. -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. +Si decide solucionar un problema, asegúrese de revisar el hilo de comentarios en caso de que alguien ya esté trabajando en una solución. Si nadie está trabajando en ello en este momento, deje un comentario que indique que desea trabajar en él para que otras personas no dupliquen accidentalmente su esfuerzo. -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. +Si alguien reclama un problema pero no hace un seguimiento por más de dos semanas, está bien que se haga cargo pero aún así debe dejar un comentario. -### Sending a Pull Request {#sending-a-pull-request} +### Enviando un 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: +El equipo principal está monitoreando los Pull Requests. Revisaremos tu Pull Request y haremos un Merge, solicitaremos cambios o lo con una explicación. Para los cambios de API, es posible que tengamos que arreglar nuestros usos internos en Facebook.com, lo que podría causar algún retraso. Haremos nuestro mejor esfuerzo para proporcionar actualizaciones y comentarios durante todo el proceso. -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 un Pull Request**, asegúrese de que se haga lo siguiente: -### Contributor License Agreement (CLA) {#contributor-license-agreement-cla} +1. Haga un Fork de [el repositorio](https://github.com/facebook/react) y cree su rama desde `master`. +2. Ejecute `yarn` en la raíz del repositorio. +3. Si ha corregido un error o ha agregado un código que debería probarse, ¡agregue pruebas! +4. Asegúrese de que el conjunto de pruebas pasa (`yarn test`). Consejo: `yarn test --watch TestName` es útil en el desarrollo. +5. Ejecute `yarn test-prod` para probar en el entorno de producción. Es compatible con las mismas opciones que `yarn test`. +6. Si necesita un depurador, ejecute `yarn debug-test --watch TestName`, abra `chrome://inspect` y presione "Inspeccionar". +7. Formatea tu código con [prettier](https://github.com/prettier/prettier) (`yarn prettier`). +8. Asegúrese de que su código corra (`yarn lint`). Consejo: `yarn linc` para verificar solo los archivos modificados. +9. Ejecute los controles de tipo [Flow](https://flowtype.org/) (`yarn flow`). +10. Si aún no lo has hecho, completa el 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. +### Acuerdo de Licencia de Contribuidor (CLA) {#contributor-license-agreement-cla} -**[Complete your CLA here.](https://code.facebook.com/cla)** +Para aceptar su pull request, necesitamos que envíe un CLA. Solo necesitas hacer esto una vez, así que si lo has hecho para otro proyecto de código abierto de Facebook, estás listo. Si está enviando un pull request por primera vez, háganos saber que ha completado el CLA y podemos verificarlo con su nombre de usuario de GitHub. -### Contribution Prerequisites {#contribution-prerequisites} +**[Completa tu CLA aquí.](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. +### Prerequisitos para Contribuir {#contribution-prerequisites} -### Development Workflow {#development-workflow} +* Tienes [Node](https://nodejs.org) instalado con v8.0.0+ y [Yarn](https://yarnpkg.com/en/) con v1.2.0+. +* Tienes `gcc` instalado o te sientes cómodo instalando un compilador si es necesario. Algunas de nuestras dependencias pueden requerir un paso de compilación. En OS X, las herramientas de línea de comandos de Xcode cubrirán esto. En Ubuntu, `apt-get install build-essential` instalará los paquetes necesarios. Comandos similares deberían funcionar en otras distribuciones de Linux. Windows requerirá algunos pasos adicionales, consulte las [instrucciones de instalación de `node-gyp`](https://github.com/nodejs/node-gyp#installation) para obtener más información. +* Usted está familiarizado con Git. -After cloning React, run `yarn` to fetch its dependencies. -Then, you can run several commands: +### Flujo de Trabajo de Desarrollo {#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. +Después de clonar React, ejecute `yarn` para obtener sus dependencias. +A continuación, puede ejecutar varios 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` comprueba el estilo del código. +* `yarn Linc` es como` Yarn Lint` pero más rápido porque solo verifica los archivos que difieren en tu rama. +* `yarn test` ejecuta el conjunto total de pruebas. +* `yarn test --Watch` ejecuta un observador de pruebas interactivo. +* `yarn test ` ejecuta pruebas con nombres de archivos que coincidan. +* `yarn test-prod` ejecuta pruebas en el entorno de producción. Es compatible con todas las mismas opciones que `yarn test`. +* `yarn debug-test` es igual que` yarn test` pero con un depurador. Abra `chrome://inspect` y presione "Inspeccionar". +* `yarn flow` ejecuta todas las comprobaciones de tipos [Flow](https://flowtype.org/). +* `yarn build` crea una carpeta` build` con todos los paquetes. +* `yarn build react/index,react-dom/index --type=UMD` crea las compilaciones UMD de solo React y ReactDOM. -First, run `yarn build`. This will produce pre-built bundles in `build` folder, as well as prepare npm packages inside `build/packages`. +Recomendamos ejecutar `yarn test` (o sus variaciones anteriores) para asegurarse de no introducir ninguna regresión mientras trabaja en su cambio. Sin embargo, puede ser útil probar su compilación de React en un proyecto 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. +En primer lugar, ejecute `yarn build`. Esto producirá paquetes predefinidos en la carpeta `build`, así como también preparará paquetes npm dentro de `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: +La forma más fácil de probar tus cambios es ejecutar `yarn build react/index,react-dom/index --type=UMD` y luego abrir `fixtures/packaging/babel-standalone/dev.html`. Este archivo ya utiliza `react.development.js` de la carpeta` build` por lo que recogerá sus cambios. + +Si desea probar los cambios en su proyecto React existente, puede copiar `build/dist/react.development.js`,`build/dist/react-dom.development.js`, o cualquier otro producto de compilación en su aplicación y usarlos en lugar de la versión estable. Si su proyecto usa React desde npm, puede eliminar `react` y` react-dom` en sus dependencias y usar `yarn link` para apuntarlos a su carpeta local `build`: ```sh -cd ~/path_to_your_react_clone/build/node_modules/react +cd ~/ruta_a_tu_clon_react/build/node_modules/react yarn link -cd ~/path_to_your_react_clone/build/node_modules/react-dom +cd ~/ruta_a_tu_clon_react/build/node_modules/ react-dom yarn link -cd /path/to/your/project +cd /ruta/a/tu/proyecto 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. +Cada vez que ejecute `yarn build` en la carpeta React, las versiones actualizadas aparecerán en los` node_modules` de su proyecto. A continuación, puede reconstruir su proyecto para probar sus cambios. -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. +Aún requerimos que su pull request contenga pruebas unitarias para cualquier funcionalidad nueva. De esta manera podemos asegurarnos de no romper tu código en el futuro. ### Style Guide {#style-guide} -We use an automatic code formatter called [Prettier](https://prettier.io/). -Run `yarn prettier` after making any changes to the code. +Utilizamos un formateador de código automático llamado [Prettier](https://prettier.io/). +Ejecute `yarn prettier` después de realizar cualquier cambio en el código. + +Luego, nuestra guía detectará la mayoría de los problemas que puedan existir en su código. +Puede verificar el estado de su estilo de código simplemente ejecutando `yarn linc`. -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`. +Sin embargo, todavía hay algunos estilos que la impresora no puede recoger. Si no está seguro de algo, consulte la [Guía de estilo de Airbnb](https://github.com/airbnb/javascript) que lo guiará en la dirección correcta. -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. +### Video Introductorio {#introductory-video} -### Introductory Video {#introductory-video} +Es posible que le interese ver [este breve video](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos) que brinda una introducción sobre cómo contribuir a React. -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. +#### Videos Destacados: {#video-highlights} -#### 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 -- [14:43](https://youtu.be/wUpPsEcGsg8?t=14m43s) - React npm registry -- [19:15](https://youtu.be/wUpPsEcGsg8?t=19m15s) - Adding new React features +- [4:12](https://youtu.be/wUpPsEcGsg8?t=4m12s) - Construir y probar React localmente +- [6:07](https://youtu.be/wUpPsEcGsg8?t=6m7s) - Creando y enviando pull requests +- [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizando el código +- [14:43](https://youtu.be/wUpPsEcGsg8?t=14m43s) - Registro de React en npm +- [19:15](https://youtu.be/wUpPsEcGsg8?t=19m15s) - Adición de nuevas funcionalidades a 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 obtener una descripción realista de lo que _feels_ le gusta contribuir a Reaccionar por primera vez, echa un vistazo a [esta entretenida charla de ReactNYC](https://www.youtube.com/watch?v=GWCcZ6fnpn4). -### Request for Comments (RFC) {#request-for-comments-rfc} +### Solicitud de comentarios (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. +Muchos cambios, incluyendo correcciones de errores y mejoras en la documentación, se pueden implementar y revisar a través del flujo de trabajo normal de pull request de 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. +Sin embargo, algunos cambios son "sustanciales", y pedimos que se sometan a un proceso de diseño y produzcan un consenso entre el equipo central de 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). +El proceso "RFC" (solicitud de comentarios) tiene como objetivo proporcionar una ruta coherente y controlada para que las nuevas características ingresen al proyecto. Puede contribuir visitando el [repositorio de rfcs](https://github.com/reactjs/rfcs). -### License {#license} +### Licencia {#license} -By contributing to React, you agree that your contributions will be licensed under its MIT license. +Al contribuir a React, acepta que sus contribuciones se otorgarán bajo su licencia MIT. -### What Next? {#what-next} +### Que hay luego? {#what-next} -Read the [next section](/docs/codebase-overview.html) to learn how the codebase is organized. +Lea la [sección siguiente](/docs/codebase-overview.html) para saber cómo está organizado el código base. diff --git a/content/docs/nav.yml b/content/docs/nav.yml index d35b7f015..5b0f25f22 100644 --- a/content/docs/nav.yml +++ b/content/docs/nav.yml @@ -126,7 +126,7 @@ - title: Contributing items: - id: how-to-contribute - title: How to Contribute + title: ¿Cómo Contribuir? - id: codebase-overview title: Codebase Overview - id: implementation-notes From eb1c937b5104d7a48e258665d4a39a1bc97fbb83 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rainer=20Mart=C3=ADnez=20Fraga?= Date: Sat, 23 Feb 2019 23:20:33 -0500 Subject: [PATCH 2/4] Fix line numbers --- content/docs/how-to-contribute.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index 082453524..f80d07c35 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -11,7 +11,6 @@ redirect_from: React es uno de los primeros proyectos de código abierto de Facebook que se encuentran bajo una fase de desarrollo activa y también se utiliza para entregar productos de sofware a todos en [facebook.com](https://www.facebook.com). Todavía estamos trabajando en los problemas para hacer que la contribución a este proyecto sea lo más fácil y transparente posible, pero aún no hemos llegado a ese punto. Esperamos que este documento haga que el proceso de contribución sea claro y responda algunas preguntas que pueda tener. - ### [Codigo de Conducta](https://code.facebook.com/codeofconduct) {#code-of-conduct} Facebook ha adoptado un Código de conducta que esperamos que los participantes del proyecto cumplan. Lea [el texto completo](https://code.facebook.com/codeofconduct) para que pueda comprender qué acciones serán o no toleradas. @@ -26,8 +25,6 @@ Haremos todo lo posible para mantener la [rama `maestra`](https://github.com/fac Si envías un pull request, hazlo contra la rama `master`. Mantenemos ramas estables para las versiones principales por separado, pero no aceptamos pull requests directamente a ellas. En su lugar, seleccionamos los cambios que no se rompen de la versión principal a la última versión estable. -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. - ### Versionamiento Semántico {#semantic-versioning} React sigue [el versionamiento semántico](http://semver.org/). Lanzamos versiones de parches para correcciones de errores, versiones secundarias para nuevas funciones y versiones principales para cualquier cambio importante. Cuando hacemos cambios importantes, también introducimos advertencias de descontinuación en una versión menor para que nuestros usuarios conozcan los próximos cambios y migren su código de antemano. @@ -77,7 +74,6 @@ Si alguien reclama un problema pero no hace un seguimiento por más de dos seman ### Enviando un Pull Request {#sending-a-pull-request} - El equipo principal está monitoreando los Pull Requests. Revisaremos tu Pull Request y haremos un Merge, solicitaremos cambios o lo con una explicación. Para los cambios de API, es posible que tengamos que arreglar nuestros usos internos en Facebook.com, lo que podría causar algún retraso. Haremos nuestro mejor esfuerzo para proporcionar actualizaciones y comentarios durante todo el proceso. **Antes de enviar un Pull Request**, asegúrese de que se haga lo siguiente: @@ -157,7 +153,6 @@ Sin embargo, todavía hay algunos estilos que la impresora no puede recoger. Si Es posible que le interese ver [este breve video](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos) que brinda una introducción sobre cómo contribuir a React. #### Videos Destacados: {#video-highlights} - - [4:12](https://youtu.be/wUpPsEcGsg8?t=4m12s) - Construir y probar React localmente - [6:07](https://youtu.be/wUpPsEcGsg8?t=6m7s) - Creando y enviando pull requests - [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizando el código From 591f8b8b670fb6d453da58331ca1b9c92947084b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rainer=20Mart=C3=ADnez=20Fraga?= Date: Sun, 24 Feb 2019 00:17:07 -0500 Subject: [PATCH 3/4] Update how-to-contribute.md --- 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 1bb564b5e..ef241e5c4 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -1,6 +1,6 @@ --- id: how-to-contribute -title: ¿Cómo Contribuir? +title: Cómo contribuir layout: contributing permalink: docs/how-to-contribute.html next: codebase-overview.html From ef3a998d58840f37976341714b2f044dec40667e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rainer=20Mart=C3=ADnez=20Fraga?= Date: Sun, 3 Mar 2019 11:59:41 -0500 Subject: [PATCH 4/4] Apply proposed changes --- content/docs/how-to-contribute.md | 150 +++++++++++++++--------------- 1 file changed, 75 insertions(+), 75 deletions(-) diff --git a/content/docs/how-to-contribute.md b/content/docs/how-to-contribute.md index ef241e5c4..2cfc47af6 100644 --- a/content/docs/how-to-contribute.md +++ b/content/docs/how-to-contribute.md @@ -9,170 +9,170 @@ redirect_from: - "tips/introduction.html" --- -React es uno de los primeros proyectos de código abierto de Facebook que se encuentran bajo una fase de desarrollo activa y también se utiliza para entregar productos de sofware a todos en [facebook.com](https://www.facebook.com). Todavía estamos trabajando en los problemas para hacer que la contribución a este proyecto sea lo más fácil y transparente posible, pero aún no hemos llegado a ese punto. Esperamos que este documento haga que el proceso de contribución sea claro y responda algunas preguntas que pueda tener. +React es uno de los primeros proyectos de código abierto de Facebook que si bien está siendo desarrollado muy activamente, al mismo tiempo se utiliza para crear código que les llega a todos en [facebook.com](https://www.facebook.com). Todavía estamos trabajando en los problemas para hacer que la contribución a este proyecto sea lo más fácil y transparente posible, pero aún no hemos llegado a ese punto. Esperamos que este documento haga que el proceso de contribución sea claro y responda algunas preguntas que pueda tener. -### [Codigo de Conducta](https://code.facebook.com/codeofconduct) {#code-of-conduct} +### [Código de conducta](https://code.facebook.com/codeofconduct) {#code-of-conduct} -Facebook ha adoptado un Código de conducta que esperamos que los participantes del proyecto cumplan. Lea [el texto completo](https://code.facebook.com/codeofconduct) para que pueda comprender qué acciones serán o no toleradas. +Facebook ha adoptado un código de conducta que esperamos que los participantes del proyecto cumplan. Lee [el texto completo](https://code.facebook.com/codeofconduct) para que puedas comprender qué acciones serán o no toleradas. -### Desarrollo Abierto {#open-development} +### Desarrollo abierto {#open-development} -Todo el trabajo en React sucede directamente en [GitHub](https://github.com/facebook/react). Tanto los miembros del equipo central como los colaboradores externos envían pull requests que pasan por el mismo proceso de revisión. +Todo el trabajo en React sucede directamente en [GitHub](https://github.com/facebook/react). Tanto los miembros del equipo central como los colaboradores externos envían *pull requests* que pasan por el mismo proceso de revisión. -### Organizacion de Ramas {#branch-organization} +### Organización de las ramas {#branch-organization} -Haremos todo lo posible para mantener la [rama `maestra`](https://github.com/facebook/react/tree/master) en buen estado, con pruebas que pasen todo el tiempo. Pero para avanzar rápidamente, realizaremos cambios en la API con los que tu aplicación podría no ser compatible. Recomendamos que uses [la última versión estable de React](/downloads.html). +Haremos todo lo posible por mantener la [rama `master`](https://github.com/facebook/react/tree/master) en buen estado, con pruebas que pasen todo el tiempo. Pero para avanzar rápidamente, realizaremos cambios en la API con los que tu aplicación podría no ser compatible. Recomendamos que uses [la última versión estable de React](/downloads.html). -Si envías un pull request, hazlo contra la rama `master`. Mantenemos ramas estables para las versiones principales por separado, pero no aceptamos pull requests directamente a ellas. En su lugar, seleccionamos los cambios que no se rompen de la versión principal a la última versión estable. +Si envías un *pull request*, hazlo contra la rama `master`. Mantenemos ramas estables para las versiones principales por separado, pero no aceptamos *pull requests* directamente a ellas. En su lugar, seleccionamos cambios compatibles de la rama *master* y los pasamos a la última versión mayor estable. -### Versionamiento Semántico {#semantic-versioning} +### Versionado semántico {#semantic-versioning} -React sigue [el versionamiento semántico](https://semver.org/). Lanzamos versiones de parches para correcciones de errores, versiones secundarias para nuevas funciones y versiones principales para cualquier cambio importante. Cuando hacemos cambios importantes, también introducimos advertencias de descontinuación en una versión menor para que nuestros usuarios conozcan los próximos cambios y migren su código de antemano. +React sigue [el versionado semántico](https://semver.org/). Lanzamos versiones de parches para correcciones de errores, versiones menores para nuevas funciones y versiones mayores para cualquier cambio importante. Cuando hacemos cambios importantes, también introducimos advertencias de descontinuación en una versión menor para que nuestros usuarios conozcan los próximos cambios y migren su código de antemano. -Etiquetamos cada pull request con un rótulo que indica si el cambio debería ir en la siguiente version [parche](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-patch), [menor](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-minor), o [mayor](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-major). Lanzamos nuevas versiones de parches cada pocas semanas, versiones menores cada pocos meses y versiones mayores una o dos veces al año. +Etiquetamos cada *pull request* con un rótulo que indica si el cambio debería ir en la siguiente versión de [parche](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-patch), [menor](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-minor), o [mayor](https://github.com/facebook/react/pulls?q=is:open+is:pr+label:semver-major). Lanzamos nuevas versiones de parches cada pocas semanas, versiones menores cada pocos meses y versiones mayores una o dos veces al año. Cada cambio significativo se documenta en el [archivo de registro de cambios](https://github.com/facebook/react/blob/master/CHANGELOG.md). -### Bugs {#bugs} +### Errores {#bugs} -#### Donde Encontrar Problemas Conocidos {#where-to-find-known-issues} +#### Dónde encontrar problemas conocidos {#where-to-find-known-issues} -Estamos utilizando [GitHub Issues](https://github.com/facebook/react/issues) para nuestros bugs. Mantenemos una estrecha vigilancia sobre esto y tratamos de avisar cuando tenemos una solución interna en curso. Antes de reportar un nuevo problema, asegúrese de que su bug no haya sido reportado. +Estamos utilizando el sistema de [*incidencias* de GitHub](https://github.com/facebook/react/issues) para nuestros errores públicos. Mantenemos una estrecha vigilancia sobre esto y tratamos de avisar cuando tenemos una solución interna en curso. Antes de hacer un nuevo reporte, asegúrate de que tu problema no exista ya. -#### Reportando Nuevos Problemas {#reporting-new-issues} +#### Reportando nuevas incidencias {#reporting-new-issues} -La mejor manera de solucionar su bug es proporcionar un caso de prueba reducido. Esta [plantilla JSFiddle](https://jsfiddle.net/Luktwrdm/) es un gran punto de partida. +La mejor manera de solucionar tu error es proporcionar un caso de prueba reducido. Esta [plantilla JSFiddle](https://jsfiddle.net/Luktwrdm/) es un gran punto de partida. -#### Bugs de Seguridad {#security-bugs} +#### Errores de seguridad {#security-bugs} -Facebook tiene un [programa de recompensas](https://www.facebook.com/whitehat/) para la divulgación segura de errores de seguridad. Con esto en mente, por favor no envie problemas públicos. Siga el proceso descrito en esa página. +Facebook tiene un [programa de recompensas](https://www.facebook.com/whitehat/) para la divulgación segura de errores de seguridad. Con esto en mente, por favor, no abras incidencias públicas. Sigue el proceso descrito en esa página. -### Como entrar en contacto {#how-to-get-in-touch} +### Cómo entrar en contacto {#how-to-get-in-touch} * IRC: [#reactjs en freenode](https://webchat.freenode.net/?channels=reactjs) -* Foro de discusión: [Discuss.reactjs.org](https://discuss.reactjs.org/) +* Foro de discusión: [discuss.reactjs.org](https://discuss.reactjs.org/) -También hay [una comunidad activa de usuarios de React en la plataforma de chat Discord](https://www.reactiflux.com/) en caso de que necesite ayuda con React. +También hay [una comunidad activa de usuarios de React en la plataforma de chat Discord](https://www.reactiflux.com/) en caso de que necesites ayuda con React. -### Proponiendo un Cambio {#proposing-a-change} +### Proponer un cambio {#proposing-a-change} -Si tiene la intención de cambiar la API pública o realizar cambios no triviales en la implementación, recomendamos [presentar el problema](https://github.com/facebook/react/issues/new). Esto nos permite llegar a un acuerdo sobre su propuesta antes que le ponga un gran esfuerzo. +Si tiene la intención de cambiar la API pública o realizar cambios no triviales en la implementación, recomendamos [abrir una incidencia](https://github.com/facebook/react/issues/new). Esto nos permite llegar a un acuerdo sobre tu propuesta antes que le pongas un gran esfuerzo. -Si solo está solucionando un error, está bien enviar un pull request de inmediato, pero le recomendamos que presente el problema que detalle que es lo que está solucionando. Esto es útil en caso de que no aceptemos esa solución en particular, pero de todas maneras queremos hacer el seguimiento del problema. +Si solo estás solucionando un error, está bien enviar un *pull request* de inmediato, pero seguimos recomendando que abras una incidencia que detalle que es lo que estás solucionando. Esto es útil en caso de que no aceptemos esa solución en particular, pero aún queramos hacer el seguimiento del problema. -### Tu Primer Pull Request {#your-first-pull-request} +### Tu primer pull request {#your-first-pull-request} -¿Trabajando en tu primer Pull Request? Puedes aprender como en esta serie de videos gratis: +¿Trabajando en tu primer *pull request*? Puedes aprender cómo en esta serie de videos gratis: **[Cómo contribuir a un proyecto de código abierto en GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)** -Para ayudarlo a empaparse los pies y familiarizarse con nuestro proceso de contribución, tenemos una lista de **[Buenas Primeras Tareas](https://github.com/facebook/react/issues?q=is:open+is:issue+label:"good+first+issue")** que contienen errores que tienen un alcance relativamente limitado. Este es un gran lugar para empezar. +Para ayudarte a familiarizarte con nuestro proceso de contribución, tenemos una lista de **[incidencias adecuadas para comenzar](https://github.com/facebook/react/issues?q=is:open+is:issue+label:"good+first+issue")** que contienen errores que tienen un alcance relativamente limitado. Este es un gran lugar para empezar. -Si decide solucionar un problema, asegúrese de revisar el hilo de comentarios en caso de que alguien ya esté trabajando en una solución. Si nadie está trabajando en ello en este momento, deje un comentario que indique que desea trabajar en él para que otras personas no dupliquen accidentalmente su esfuerzo. +Si decides solucionar una incidencia, asegúrate de revisar el hilo de comentarios en caso de que alguien ya esté trabajando en una solución. Si nadie está trabajando en ello en este momento, deja un comentario que indique que deseas trabajar en ella para que otras personas no dupliquen accidentalmente su esfuerzo. -Si alguien reclama un problema pero no hace un seguimiento por más de dos semanas, está bien que se haga cargo pero aún así debe dejar un comentario. +Si alguien reclama una incidencia pero no hace un seguimiento por más de dos semanas, está bien que te hagas cargo pero aún así debes dejar un comentario. -### Enviando un Pull Request {#sending-a-pull-request} +### Enviar un pull request {#sending-a-pull-request} -El equipo principal está monitoreando los Pull Requests. Revisaremos tu Pull Request y haremos un Merge, solicitaremos cambios o lo con una explicación. Para los cambios de API, es posible que tengamos que arreglar nuestros usos internos en Facebook.com, lo que podría causar algún retraso. Haremos nuestro mejor esfuerzo para proporcionar actualizaciones y comentarios durante todo el proceso. +El equipo principal está monitoreando los *pull requests*. Revisaremos tu *pull request* y haremos un *merge*, solicitaremos cambios o lo cerraremos con una explicación. Para los cambios de API, es posible que tengamos que arreglar nuestros usos internos en Facebook.com, lo que podría causar algún retraso. Haremos nuestro mejor esfuerzo para proporcionar actualizaciones y comentarios durante todo el proceso. -**Antes de enviar un Pull Request**, asegúrese de que se haga lo siguiente: +**Antes de enviar un _pull request_**, asegúrate de que se haga lo siguiente: -1. Haga un Fork de [el repositorio](https://github.com/facebook/react) y cree su rama desde `master`. -2. Ejecute `yarn` en la raíz del repositorio. -3. Si ha corregido un error o ha agregado un código que debería probarse, ¡agregue pruebas! -4. Asegúrese de que el conjunto de pruebas pasa (`yarn test`). Consejo: `yarn test --watch TestName` es útil en el desarrollo. -5. Ejecute `yarn test-prod` para probar en el entorno de producción. Es compatible con las mismas opciones que `yarn test`. -6. Si necesita un depurador, ejecute `yarn debug-test --watch TestName`, abra `chrome://inspect` y presione "Inspeccionar". +1. Haz un *fork* [del repositorio](https://github.com/facebook/react) y crea tu rama a partir de `master`. +2. Ejecuta `yarn` en la raíz del repositorio. +3. Si has corregido un error o has agregado un código que debería probarse, ¡agrega pruebas! +4. Asegúrate de que el conjunto de pruebas pasa (`yarn test`). Consejo: `yarn test --watch TestName` es útil en desarrollo. +5. Ejecuta `yarn test-prod` para probar en el entorno de producción. Es compatible con las mismas opciones que `yarn test`. +6. Si necesitas un depurador, ejecuta `yarn debug-test --watch TestName`, abre `chrome://inspect` y presiona "Inspeccionar". 7. Formatea tu código con [prettier](https://github.com/prettier/prettier) (`yarn prettier`). -8. Asegúrese de que su código corra (`yarn lint`). Consejo: `yarn linc` para verificar solo los archivos modificados. -9. Ejecute los controles de tipo [Flow](https://flowtype.org/) (`yarn flow`). +8. Asegúrate de ejecutar lint en tu código (`yarn lint`). Consejo: `yarn linc` para verificar solo los archivos modificados. +9. Ejecuta los controles de tipo de [Flow](https://flowtype.org/) (`yarn flow`). 10. Si aún no lo has hecho, completa el CLA. ### Acuerdo de Licencia de Contribuidor (CLA) {#contributor-license-agreement-cla} -Para aceptar su pull request, necesitamos que envíe un CLA. Solo necesitas hacer esto una vez, así que si lo has hecho para otro proyecto de código abierto de Facebook, estás listo. Si está enviando un pull request por primera vez, háganos saber que ha completado el CLA y podemos verificarlo con su nombre de usuario de GitHub. +Para aceptar tu pull request, necesitamos que envíes un CLA. Solo necesitas hacer esto una vez, así que si lo has hecho para otro proyecto de código abierto de Facebook, estás listo. Si estás enviando un *pull request* por primera vez, haznos saber que has completado el CLA y podemos verificarlo con tu nombre de usuario de GitHub. **[Completa tu CLA aquí.](https://code.facebook.com/cla)** -### Prerequisitos para Contribuir {#contribution-prerequisites} +### Prerequisitos para contribuir {#contribution-prerequisites} * Tienes [Node](https://nodejs.org) instalado con v8.0.0+ y [Yarn](https://yarnpkg.com/en/) con v1.2.0+. -* Tienes `gcc` instalado o te sientes cómodo instalando un compilador si es necesario. Algunas de nuestras dependencias pueden requerir un paso de compilación. En OS X, las herramientas de línea de comandos de Xcode cubrirán esto. En Ubuntu, `apt-get install build-essential` instalará los paquetes necesarios. Comandos similares deberían funcionar en otras distribuciones de Linux. Windows requerirá algunos pasos adicionales, consulte las [instrucciones de instalación de `node-gyp`](https://github.com/nodejs/node-gyp#installation) para obtener más información. -* Usted está familiarizado con Git. +* Tienes `gcc` instalado o te sientes cómodo instalando un compilador si es necesario. Algunas de nuestras dependencias pueden requerir un paso de compilación. En OS X, las herramientas de línea de comandos de Xcode cubrirán esto. En Ubuntu, `apt-get install build-essential` instalará los paquetes necesarios. Comandos similares deberían funcionar en otras distribuciones de Linux. Windows requerirá algunos pasos adicionales, consulta las [instrucciones de instalación de `node-gyp`](https://github.com/nodejs/node-gyp#installation) para obtener más información. +* Estás familiarizado con Git. -### Flujo de Trabajo de Desarrollo {#development-workflow} +### Flujo de trabajo de desarrollo {#development-workflow} -Después de clonar React, ejecute `yarn` para obtener sus dependencias. -A continuación, puede ejecutar varios comandos: +Después de clonar React, ejecuta `yarn` para obtener sus dependencias. +A continuación, puedes ejecutar varios comandos: * `yarn lint` comprueba el estilo del código. -* `yarn Linc` es como` Yarn Lint` pero más rápido porque solo verifica los archivos que difieren en tu rama. +* `yarn linc` es como` yarn lint` pero más rápido, porque solo verifica los archivos que difieren en tu rama. * `yarn test` ejecuta el conjunto total de pruebas. -* `yarn test --Watch` ejecuta un observador de pruebas interactivo. +* `yarn test --watch` ejecuta un observador de pruebas interactivo. * `yarn test ` ejecuta pruebas con nombres de archivos que coincidan. * `yarn test-prod` ejecuta pruebas en el entorno de producción. Es compatible con todas las mismas opciones que `yarn test`. -* `yarn debug-test` es igual que` yarn test` pero con un depurador. Abra `chrome://inspect` y presione "Inspeccionar". -* `yarn flow` ejecuta todas las comprobaciones de tipos [Flow](https://flowtype.org/). +* `yarn debug-test` es igual que` yarn test` pero con un depurador. Abre `chrome://inspect` y presiona "Inspeccionar". +* `yarn flow` ejecuta todas las comprobaciones de tipos de [Flow](https://flowtype.org/). * `yarn build` crea una carpeta` build` con todos los paquetes. -* `yarn build react/index,react-dom/index --type=UMD` crea las compilaciones UMD de solo React y ReactDOM. +* `yarn build react/index,react-dom/index --type=UMD` crea las compilaciones UMD solo de React y ReactDOM. -Recomendamos ejecutar `yarn test` (o sus variaciones anteriores) para asegurarse de no introducir ninguna regresión mientras trabaja en su cambio. Sin embargo, puede ser útil probar su compilación de React en un proyecto real. +Recomendamos ejecutar `yarn test` (o sus variaciones anteriores) para asegurarte de no introducir ninguna regresión mientras trabajas en tu cambio. Sin embargo, puede ser útil probar tu compilación de React en un proyecto real. -En primer lugar, ejecute `yarn build`. Esto producirá paquetes predefinidos en la carpeta `build`, así como también preparará paquetes npm dentro de `build/packages`. +En primer lugar, ejecuta `yarn build`. Esto producirá paquetes precompilados en la carpeta `build`, así como también preparará paquetes npm dentro de `build/packages`. -La forma más fácil de probar tus cambios es ejecutar `yarn build react/index,react-dom/index --type=UMD` y luego abrir `fixtures/packaging/babel-standalone/dev.html`. Este archivo ya utiliza `react.development.js` de la carpeta` build` por lo que recogerá sus cambios. +La forma más fácil de probar tus cambios es ejecutar `yarn build react/index,react-dom/index --type=UMD` y luego abrir `fixtures/packaging/babel-standalone/dev.html`. Este archivo ya utiliza `react.development.js` de la carpeta` build` por lo que recogerá tus cambios. -Si desea probar los cambios en su proyecto React existente, puede copiar `build/dist/react.development.js`,`build/dist/react-dom.development.js`, o cualquier otro producto de compilación en su aplicación y usarlos en lugar de la versión estable. Si su proyecto usa React desde npm, puede eliminar `react` y` react-dom` en sus dependencias y usar `yarn link` para apuntarlos a su carpeta local `build`: +Si deseas probar los cambios en tu proyecto React existente, puedes copiar `build/dist/react.development.js`,`build/dist/react-dom.development.js`, o cualquier otro producto de compilación en tu aplicación y usarlos en lugar de la versión estable. Si tu proyecto usa React desde npm, puedes eliminar `react` y` react-dom` en sus dependencias y usar `yarn link` para apuntarlos a tu carpeta local `build`: ```sh cd ~/ruta_a_tu_clon_react/build/node_modules/react yarn link -cd ~/ruta_a_tu_clon_react/build/node_modules/ react-dom +cd ~/ruta_a_tu_clon_react/build/node_modules/react-dom yarn link cd /ruta/a/tu/proyecto yarn link react react-dom ``` -Cada vez que ejecute `yarn build` en la carpeta React, las versiones actualizadas aparecerán en los` node_modules` de su proyecto. A continuación, puede reconstruir su proyecto para probar sus cambios. +Cada vez que ejecutes `yarn build` en la carpeta React, las versiones actualizadas aparecerán dentro de `node_modules` en tu proyecto. A continuación, puedes reconstruir tu proyecto para probar tus cambios. -Aún requerimos que su pull request contenga pruebas unitarias para cualquier funcionalidad nueva. De esta manera podemos asegurarnos de no romper tu código en el futuro. +Aún requerimos que tu *pull request* contenga pruebas unitarias para cualquier funcionalidad nueva. De esta manera podemos asegurarnos de que tu código no falle en el futuro. -### Style Guide {#style-guide} +### Guía de estilo {#style-guide} Utilizamos un formateador de código automático llamado [Prettier](https://prettier.io/). -Ejecute `yarn prettier` después de realizar cualquier cambio en el código. +Ejecuta `yarn prettier` después de realizar cualquier cambio en el código. -Luego, nuestra guía detectará la mayoría de los problemas que puedan existir en su código. -Puede verificar el estado de su estilo de código simplemente ejecutando `yarn linc`. +Luego, nuestra guía detectará la mayoría de los problemas que puedan existir en tu código. +Puedes verificar el estado de tu estilo de código simplemente ejecutando `yarn linc`. -Sin embargo, todavía hay algunos estilos que la impresora no puede recoger. Si no está seguro de algo, consulte la [Guía de estilo de Airbnb](https://github.com/airbnb/javascript) que lo guiará en la dirección correcta. +Sin embargo, todavía hay algunos estilos que el *linter* no puede recoger. Si no estás seguro de algo, consulta la [Guía de estilo de Airbnb](https://github.com/airbnb/javascript) que te guiará en la dirección correcta. -### Video Introductorio {#introductory-video} +### Video introductorio {#introductory-video} -Es posible que le interese ver [este breve video](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos) que brinda una introducción sobre cómo contribuir a React. +Es posible que te interese ver [este breve video](https://www.youtube.com/watch?v=wUpPsEcGsg8) (26 minutos) que brinda una introducción sobre cómo contribuir a React. -#### Videos Destacados: {#video-highlights} +#### Momentos destacados del video: {#video-highlights} - [4:12](https://youtu.be/wUpPsEcGsg8?t=4m12s) - Construir y probar React localmente -- [6:07](https://youtu.be/wUpPsEcGsg8?t=6m7s) - Creando y enviando pull requests -- [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizando el código +- [6:07](https://youtu.be/wUpPsEcGsg8?t=6m7s) - Crear y enviar *pull requests* +- [8:25](https://youtu.be/wUpPsEcGsg8?t=8m25s) - Organizar el código - [14:43](https://youtu.be/wUpPsEcGsg8?t=14m43s) - Registro de React en npm - [19:15](https://youtu.be/wUpPsEcGsg8?t=19m15s) - Adición de nuevas funcionalidades a React -Para obtener una descripción realista de lo que _feels_ le gusta contribuir a Reaccionar por primera vez, echa un vistazo a [esta entretenida charla de ReactNYC](https://www.youtube.com/watch?v=GWCcZ6fnpn4). +Para obtener una descripción realista de lo que se _siente_ contribuir a React por primera vez, echa un vistazo a [esta entretenida charla de ReactNYC](https://www.youtube.com/watch?v=GWCcZ6fnpn4). ### Solicitud de comentarios (RFC) {#request-for-comments-rfc} -Muchos cambios, incluyendo correcciones de errores y mejoras en la documentación, se pueden implementar y revisar a través del flujo de trabajo normal de pull request de GitHub. +Muchos cambios, incluyendo correcciones de errores y mejoras en la documentación, se pueden implementar y revisar a través del flujo de trabajo normal de *pull request* de GitHub. Sin embargo, algunos cambios son "sustanciales", y pedimos que se sometan a un proceso de diseño y produzcan un consenso entre el equipo central de React. -El proceso "RFC" (solicitud de comentarios) tiene como objetivo proporcionar una ruta coherente y controlada para que las nuevas características ingresen al proyecto. Puede contribuir visitando el [repositorio de rfcs](https://github.com/reactjs/rfcs). +El proceso "RFC" (solicitud de comentarios) tiene como objetivo proporcionar una ruta coherente y controlada para que las nuevas características ingresen al proyecto. Puedes contribuir visitando el [repositorio rfcs](https://github.com/reactjs/rfcs). ### Licencia {#license} -Al contribuir a React, acepta que sus contribuciones se otorgarán bajo su licencia MIT. +Al contribuir a React, aceptas que tus contribuciones se otorgarán bajo su licencia MIT. -### Que hay luego? {#what-next} +### ¿Qué hay luego? {#what-next} -Lea la [sección siguiente](/docs/codebase-overview.html) para saber cómo está organizado el código base. +Lee la [sección siguiente](/docs/codebase-overview.html) para saber cómo está organizada la base de código.