From 8b9e1eba6f84db271c4494885de82fc9bdd9c17a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Alejandro=20Garc=C3=ADa=20Salas?= Date: Fri, 15 Feb 2019 15:18:20 -0800 Subject: [PATCH 01/14] Translate faq-versioning to spanish There's a few words that I am not 100% sure about the translation, some of those are: * breaking changes * major/minor version * package I tried to be consistent as much as possible. I also changed the link that pointed to the english version of the semver docs to [the one in spanish](https://semver.org/lang/es/). --- content/docs/faq-versioning.md | 48 +++++++++++++++++----------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index b51ea4895..18a918765 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -1,48 +1,48 @@ --- id: faq-versioning -title: Versioning Policy +title: Política de versiones permalink: docs/faq-versioning.html layout: docs category: FAQ --- -React follows [semantic versioning (semver)](https://semver.org/) principles. +React sigue los principios de [versionado semántico (semver)](https://semver.org/lang/es/). -That means that with a version number **x.y.z**: +Esto significa que con un número de versión **x.y.z**: -* When releasing **breaking changes**, we make a **major release** by changing the **x** number (ex: 15.6.2 to 16.0.0). -* When releasing **new features**, we make a **minor release** by changing the **y** number (ex: 15.6.2 to 15.7.0). -* When releasing **bug fixes**, we make a **patch release** by changing the **z** number (ex: 15.6.2 to 15.6.3). +* Al publicar **cambios de ruptura**, hacemos una **publicación mayor** cambiando el número **x** (ej: 15.6.2 a 16.0.0). +* Al publicar **nueva funcionalidad**, hacemos una **publicación menor** cambiando el número **y** (ej: 15.6.2 a 15.7.0). +* Al publicar **correcciones de bugs**, publicamos un **patch** cambiando el número **z** (ej: 15.6.2 a 15.6.3). -Major releases can also contain new features, and any release can include bug fixes. +Las publicaciones mayores también pueden contener nueva funcionalidad, y cualquier versión puede incluir correcciones de bugs. -### Breaking Changes {#breaking-changes} +### Rompiendo cambios {#breaking-changes} -Breaking changes are inconvenient for everyone, so we try to minimize the number of major releases – for example, React 15 was released in April 2016 and React 16 was released in September 2017; React 17 isn't expected until 2019. +Los cambios de ruptura son inconvenientes para todos, por lo que intentamos minimizar el número de publicaciones importantes – por ejemplo, React 15 fue publicado en abril de 2016 y React 16 fue publicado en septiembre de 2017; no esperamos publicar React 17 hasta el 2019. -Instead, we release new features in minor versions. That means that minor releases are often more interesting and compelling than majors, despite their unassuming name. +En cambio, publicamos nueva funcionalidad en versiones menores. Esto significa que las publicaciones menores son a menudo más interesantes que las publicaciones mayores, a pesar de su modesto nombre. -### Commitment to Stability {#commitment-to-stability} +### Compromiso a la estabilidad {#commitment-to-stability} -As we change React over time, we try to minimize the effort required to take advantage of new features. When possible, we'll keep an older API working, even if that means putting it in a separate package. For example, [mixins have been discouraged for years](/blog/2016/07/13/mixins-considered-harmful.html) but they're supported to this day [via create-react-class](/docs/react-without-es6.html#mixins) and many codebases continue to use them in stable, legacy code. +A medida que actualizamos React, intentamos minimizar el esfuerzo necesario para aprovechar nueva funcionalidad. Cuando sea posible, mantendremos un API antiguo funcionando, incluso si eso significa ponerlo en un *package* separado. Por ejemplo, [el uso de mixins ha sido desalentado durante años](/blog/2016/07/13/mixins-considered-harmful.html) pero están respaldados hasta este día [a través de la clase create-react-class](/docs/react-without-es6.html#mixins) y muchos *codebases* siguen utilizándolos en código estable y *legacy*. -Over a million developers use React, collectively maintaining millions of components. The Facebook codebase alone has over 50,000 React components. That means we need to make it as easy as possible to upgrade to new versions of React; if we make large changes without a migration path, people will be stuck on old versions. We test these upgrade paths on Facebook itself – if our team of less than 10 people can update 50,000+ components alone, we hope the upgrade will be manageable for anyone using React. In many cases, we write [automated scripts](https://github.com/reactjs/react-codemod) to upgrade component syntax, which we then include in the open-source release for everyone to use. +Más de un millón de desarrolladores utilizan React, manteniendo colectivamente millones de componentes. Solamente el codebase de Facebook tiene más de 50.000 componentes de React. Esto significa que tenemos hacer que sea lo más fácil posible actualizar a nuevas versiones de React; si hacemos grandes cambios sin un camino de migración, la gente se quedará atrapada en versiones antiguas. Probamos estas rutas de actualización en Facebook mismo – si nuestro equipo de menos de 10 personas puede actualizar 50.000 componentes, esperamos que la actualización sea manejable para cualquiera que utilice React. En muchos casos, escribimos [scripts automatizados](https://github.com/reactjs/react-codemod) para actualizar la sintaxis de componentes, que luego incluimos en la versión de código abierto para que todo el mundo los utilice. -### Gradual Upgrades via Warnings {#gradual-upgrades-via-warnings} +### Mejoras graduales a través de advertencias {#gradual-upgrades-via-warnings} -Development builds of React include many helpful warnings. Whenever possible, we add warnings in preparation for future breaking changes. That way, if your app has no warnings on the latest release, it will be compatible with the next major release. This allows you to upgrade your apps one component at a time. +Las versiones de desarrollo de React incluyen muchas advertencias útiles. Siempre que sea posible, añadimos advertencias en preparación a futuros cambios de ruptura. De esta manera, si tu aplicación no tiene advertencias en la última versión, ella será compatible con la próxima versión mayor. Esto te permite actualizar tu aplicación un componente a la vez. -Development warnings won't affect the runtime behavior of your app. That way, you can feel confident that your app will behave the same way between the development and production builds -- the only differences are that the production build won't log the warnings and that it is more efficient. (If you ever notice otherwise, please file an issue.) +Las advertencias de desarrollo no afectarán el comportamiento en tiempo de ejecución de tu aplicación. De esa manera, puedes sentir la confianza de que tu aplicación se comportará de la misma manera entre la versión de desarrollo y la versión de producción -- las únicas diferencias son que la versión de producción no registrará las advertencias y es más eficiente. (Si alguna vez observa lo contrario, por favor presentar un *issue*.) -### What Counts as a Breaking Change? {#what-counts-as-a-breaking-change} +### ¿Qué cuenta como un cambio de ruptura? {#what-counts-as-a-breaking-change} -In general, we *don't* bump the major version number for changes to: +En general, *no publicamos* una versión mayor por cambios a: -* **Development warnings.** Since these don't affect production behavior, we may add new warnings or modify existing warnings in between major versions. In fact, this is what allows us to reliably warn about upcoming breaking changes. -* **APIs starting with `unstable_`.** These are provided as experimental features whose APIs we are not yet confident in. By releasing these with an `unstable_` prefix, we can iterate faster and get to a stable API sooner. -* **Alpha and canary versions of React.** We provide alpha versions of React as a way to test new features early, but we need the flexibility to make changes based on what we learn in the alpha period. If you use these versions, note that APIs may change before the stable release. -* **Undocumented APIs and internal data structures.** If you access internal property names like `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` or `__reactInternalInstance$uk43rzhitjg`, there is no warranty. You are on your own. +* **Advertencias de desarrollo.** Dado que no afectan al comportamiento de producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre las versiones mayores. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios de ruptura. +* **APIs que comienzan con `unstable_`.** Estos ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. +* **Versiones alfa y canarias de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características temprano, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. +* **APIs no documentadas y estructuras de datos internas.** Si accede a nombres de propiedad interna como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Usted está por su cuenta. -This policy is designed to be pragmatic: certainly, we don't want to cause headaches for you. If we bumped the major version for all of these changes, we would end up releasing more major versions and ultimately causing more versioning pain for the community. It would also mean that we can't make progress in improving React as fast as we'd like. +Esta política está diseñada para ser pragmática: desde luego, no queremos causarle dolores de cabeza. Si publicaramos una nueva versión mayor por cada uno de estos cambios, acabaríamos publicando más versiones mayores y causaríamos más inconveniencias a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. -That said, if we expect that a change on this list will cause broad problems in the community, we will still do our best to provide a gradual migration path. +Dicho esto, si creemos que algún cambio en esta lista va a provocar grandes problemas en la comunidad, haremos todo lo posible para proporcionar un camino de migración gradual. From e48d4de26f2597f914f09cebd433aa5c09051228 Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 10:58:05 -0800 Subject: [PATCH 02/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index 18a918765..96a3b5adc 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -45,4 +45,4 @@ En general, *no publicamos* una versión mayor por cambios a: Esta política está diseñada para ser pragmática: desde luego, no queremos causarle dolores de cabeza. Si publicaramos una nueva versión mayor por cada uno de estos cambios, acabaríamos publicando más versiones mayores y causaríamos más inconveniencias a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. -Dicho esto, si creemos que algún cambio en esta lista va a provocar grandes problemas en la comunidad, haremos todo lo posible para proporcionar un camino de migración gradual. +Dicho esto, si creemos que algún cambio en esta lista va a provocar grandes problemas en la comunidad, haremos todo lo posible para proporcionar una guía de migración gradual. From 6378b4f090c9292c3b1f053214a80c0fef3ce2dc Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 10:58:20 -0800 Subject: [PATCH 03/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index 96a3b5adc..cb146ea40 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -1,6 +1,6 @@ --- id: faq-versioning -title: Política de versiones +title: Política de Versiones permalink: docs/faq-versioning.html layout: docs category: FAQ From d3b052f58ef37d0047194bbc8f9f655a3f317751 Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 10:58:46 -0800 Subject: [PATCH 04/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index cb146ea40..d666fb674 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -16,7 +16,7 @@ Esto significa que con un número de versión **x.y.z**: Las publicaciones mayores también pueden contener nueva funcionalidad, y cualquier versión puede incluir correcciones de bugs. -### Rompiendo cambios {#breaking-changes} +### Cambios con Rupturas {#breaking-changes} Los cambios de ruptura son inconvenientes para todos, por lo que intentamos minimizar el número de publicaciones importantes – por ejemplo, React 15 fue publicado en abril de 2016 y React 16 fue publicado en septiembre de 2017; no esperamos publicar React 17 hasta el 2019. From 1bba21bacc02b5de52418d9730560e9276607301 Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 10:59:03 -0800 Subject: [PATCH 05/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index d666fb674..cf0bbe931 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -30,7 +30,7 @@ Más de un millón de desarrolladores utilizan React, manteniendo colectivamente ### Mejoras graduales a través de advertencias {#gradual-upgrades-via-warnings} -Las versiones de desarrollo de React incluyen muchas advertencias útiles. Siempre que sea posible, añadimos advertencias en preparación a futuros cambios de ruptura. De esta manera, si tu aplicación no tiene advertencias en la última versión, ella será compatible con la próxima versión mayor. Esto te permite actualizar tu aplicación un componente a la vez. +Las versiones de desarrollo de React incluyen muchas advertencias útiles. Siempre que es posible, añadimos advertencias en preparación a futuros cambios con rupturas. De esta manera, si tu aplicación no tiene advertencias en el último lanzamiento, esta será compatible con el próximo lanzamiento importante. Esto te permite actualizar tu aplicación un componente a la vez. Las advertencias de desarrollo no afectarán el comportamiento en tiempo de ejecución de tu aplicación. De esa manera, puedes sentir la confianza de que tu aplicación se comportará de la misma manera entre la versión de desarrollo y la versión de producción -- las únicas diferencias son que la versión de producción no registrará las advertencias y es más eficiente. (Si alguna vez observa lo contrario, por favor presentar un *issue*.) From d76cc724751aa9139a422c39c9cce2e974fcb3ff Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 10:59:22 -0800 Subject: [PATCH 06/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index cf0bbe931..d56441672 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -8,7 +8,7 @@ category: FAQ React sigue los principios de [versionado semántico (semver)](https://semver.org/lang/es/). -Esto significa que con un número de versión **x.y.z**: +Esto significa que lo hace con un número de versión **x.y.z**: * Al publicar **cambios de ruptura**, hacemos una **publicación mayor** cambiando el número **x** (ej: 15.6.2 a 16.0.0). * Al publicar **nueva funcionalidad**, hacemos una **publicación menor** cambiando el número **y** (ej: 15.6.2 a 15.7.0). From b6c9d748df6b6eeeac3ea0d0553cc32ad739e9a6 Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 10:59:45 -0800 Subject: [PATCH 07/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index d56441672..19433019f 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -12,7 +12,7 @@ Esto significa que lo hace con un número de versión **x.y.z**: * Al publicar **cambios de ruptura**, hacemos una **publicación mayor** cambiando el número **x** (ej: 15.6.2 a 16.0.0). * Al publicar **nueva funcionalidad**, hacemos una **publicación menor** cambiando el número **y** (ej: 15.6.2 a 15.7.0). -* Al publicar **correcciones de bugs**, publicamos un **patch** cambiando el número **z** (ej: 15.6.2 a 15.6.3). +* Al lanzar **correcciones de errores**, hacemos el lanzamiento de un **parche** cambiando el número **z** (ej: 15.6.2 a 15.6.3). Las publicaciones mayores también pueden contener nueva funcionalidad, y cualquier versión puede incluir correcciones de bugs. From 2963d5ea5edecf60dee242e3da5bab2c059d93a3 Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 11:01:28 -0800 Subject: [PATCH 08/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index 19433019f..e41bd22f9 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -41,7 +41,7 @@ En general, *no publicamos* una versión mayor por cambios a: * **Advertencias de desarrollo.** Dado que no afectan al comportamiento de producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre las versiones mayores. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios de ruptura. * **APIs que comienzan con `unstable_`.** Estos ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. * **Versiones alfa y canarias de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características temprano, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. -* **APIs no documentadas y estructuras de datos internas.** Si accede a nombres de propiedad interna como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Usted está por su cuenta. +* **APIs no documentadas y estructuras de datos internas.** Si accedes a nombres de propiedades internas como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Estás por tu cuenta. Esta política está diseñada para ser pragmática: desde luego, no queremos causarle dolores de cabeza. Si publicaramos una nueva versión mayor por cada uno de estos cambios, acabaríamos publicando más versiones mayores y causaríamos más inconveniencias a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. From 168c3cfd9080da12e6a6b36e2207bc01e9ddf58d Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 11:05:48 -0800 Subject: [PATCH 09/14] Apply suggestions from code review Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index e41bd22f9..165827227 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -10,39 +10,39 @@ React sigue los principios de [versionado semántico (semver)](https://semver.or Esto significa que lo hace con un número de versión **x.y.z**: -* Al publicar **cambios de ruptura**, hacemos una **publicación mayor** cambiando el número **x** (ej: 15.6.2 a 16.0.0). -* Al publicar **nueva funcionalidad**, hacemos una **publicación menor** cambiando el número **y** (ej: 15.6.2 a 15.7.0). +* Al lanzar **cambios con rupturas**, hacemos un **lanzamiento importante** cambiando el número **x** (ej: 15.6.2 a 16.0.0). +* Al lanzar una **nueva funcionalidad**, hacemos un **lanzamiento menor** cambiando el número **y** (ej: 15.6.2 a 15.7.0). * Al lanzar **correcciones de errores**, hacemos el lanzamiento de un **parche** cambiando el número **z** (ej: 15.6.2 a 15.6.3). -Las publicaciones mayores también pueden contener nueva funcionalidad, y cualquier versión puede incluir correcciones de bugs. +Los lanzamientos importantes también pueden contener nuevas funcionalidades, y cualquier lanzamiento puede incluir correcciones de errores. ### Cambios con Rupturas {#breaking-changes} -Los cambios de ruptura son inconvenientes para todos, por lo que intentamos minimizar el número de publicaciones importantes – por ejemplo, React 15 fue publicado en abril de 2016 y React 16 fue publicado en septiembre de 2017; no esperamos publicar React 17 hasta el 2019. +Los cambios con rupturas son inconvenientes para todos, por lo que intentamos minimizar el número de lanzamientos importantes – por ejemplo, React 15 fue lanzado en Abril de 2016 y React 16 fue lanzado en Septiembre de 2017; no esperamos lanzar React 17 hasta el 2019. -En cambio, publicamos nueva funcionalidad en versiones menores. Esto significa que las publicaciones menores son a menudo más interesantes que las publicaciones mayores, a pesar de su modesto nombre. +En cambio, lanzamos nuevas funcionalidades en versiones menores. Esto significa que los lanzamientos menores son a menudo más interesantes que los lanzamientos importantes, a pesar de su modesto nombre. -### Compromiso a la estabilidad {#commitment-to-stability} +### Compromiso a la Estabilidad {#commitment-to-stability} -A medida que actualizamos React, intentamos minimizar el esfuerzo necesario para aprovechar nueva funcionalidad. Cuando sea posible, mantendremos un API antiguo funcionando, incluso si eso significa ponerlo en un *package* separado. Por ejemplo, [el uso de mixins ha sido desalentado durante años](/blog/2016/07/13/mixins-considered-harmful.html) pero están respaldados hasta este día [a través de la clase create-react-class](/docs/react-without-es6.html#mixins) y muchos *codebases* siguen utilizándolos en código estable y *legacy*. +A medida que actualizamos React, intentamos minimizar el esfuerzo necesario para aprovechar nuevas funcionalidades. Cuando sea posible, mantendremos un API antiguo funcionando, incluso si eso significa ponerlo en un paquete separado. Por ejemplo, [el uso de *mixins* no ha sido recomendado durante años](/blog/2016/07/13/mixins-considered-harmful.html) pero aún son aceptados hasta hoy en día [mediante el uso de create-react-class](/docs/react-without-es6.html#mixins) y muchas bases de código aún siguen utilizándolos en código estable pero antiguo. -Más de un millón de desarrolladores utilizan React, manteniendo colectivamente millones de componentes. Solamente el codebase de Facebook tiene más de 50.000 componentes de React. Esto significa que tenemos hacer que sea lo más fácil posible actualizar a nuevas versiones de React; si hacemos grandes cambios sin un camino de migración, la gente se quedará atrapada en versiones antiguas. Probamos estas rutas de actualización en Facebook mismo – si nuestro equipo de menos de 10 personas puede actualizar 50.000 componentes, esperamos que la actualización sea manejable para cualquiera que utilice React. En muchos casos, escribimos [scripts automatizados](https://github.com/reactjs/react-codemod) para actualizar la sintaxis de componentes, que luego incluimos en la versión de código abierto para que todo el mundo los utilice. +Más de un millón de desarrolladores utilizan React, manteniendo colectivamente millones de componentes. Solamente la base de código de Facebook tiene más de 50.000 componentes de React. Esto significa que tenemos que hacer lo más fácil posible actualizar a nuevas versiones de React; si hacemos grandes cambios sin una guía de actualización, la gente se quedará atascada en versiones antiguas. Probamos estas guías de actualización en Facebook – si nuestro equipo de menos de 10 personas puede actualizar 50.000 componentes por si mismos, esperamos que la actualización sea manejable para cualquiera que utilice React. En muchos casos, escribimos [*scripts* automatizados](https://github.com/reactjs/react-codemod) para actualizar la sintaxis de componentes, que luego incluimos en la versión de código abierto para que todo el mundo los utilice. -### Mejoras graduales a través de advertencias {#gradual-upgrades-via-warnings} +### Mejoras Graduales a través de Advertencias {#gradual-upgrades-via-warnings} Las versiones de desarrollo de React incluyen muchas advertencias útiles. Siempre que es posible, añadimos advertencias en preparación a futuros cambios con rupturas. De esta manera, si tu aplicación no tiene advertencias en el último lanzamiento, esta será compatible con el próximo lanzamiento importante. Esto te permite actualizar tu aplicación un componente a la vez. -Las advertencias de desarrollo no afectarán el comportamiento en tiempo de ejecución de tu aplicación. De esa manera, puedes sentir la confianza de que tu aplicación se comportará de la misma manera entre la versión de desarrollo y la versión de producción -- las únicas diferencias son que la versión de producción no registrará las advertencias y es más eficiente. (Si alguna vez observa lo contrario, por favor presentar un *issue*.) +Las advertencias de desarrollo no afectarán el comportamiento en tiempo de ejecución de tu aplicación. De esa manera, puedes estar seguro de que tu aplicación se comportará de la misma manera entre la versión de desarrollo y la versión de producción -- las únicas diferencias son que la versión de producción no registrará las advertencias y es más eficiente. (Si alguna vez observas lo contrario, por favor abre un caso). -### ¿Qué cuenta como un cambio de ruptura? {#what-counts-as-a-breaking-change} +### ¿Qué cuenta como un Cambio con Rupturas? {#what-counts-as-a-breaking-change} -En general, *no publicamos* una versión mayor por cambios a: +En general, *no publicamos* una versión importante por cambios a: -* **Advertencias de desarrollo.** Dado que no afectan al comportamiento de producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre las versiones mayores. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios de ruptura. +* **Advertencias de desarrollo.** Dado que no afectan el comportamiento en producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre versiones importantes. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios con rupturas. * **APIs que comienzan con `unstable_`.** Estos ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. * **Versiones alfa y canarias de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características temprano, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. * **APIs no documentadas y estructuras de datos internas.** Si accedes a nombres de propiedades internas como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Estás por tu cuenta. -Esta política está diseñada para ser pragmática: desde luego, no queremos causarle dolores de cabeza. Si publicaramos una nueva versión mayor por cada uno de estos cambios, acabaríamos publicando más versiones mayores y causaríamos más inconveniencias a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. +Esta política está diseñada para ser pragmática: desde luego, no queremos causarte dolores de cabeza. Si publicáramos una nueva versión importante por cada uno de estos cambios, acabaríamos lanzando más versiones importantes y causaríamos más inconvenientes con el versionado a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. Dicho esto, si creemos que algún cambio en esta lista va a provocar grandes problemas en la comunidad, haremos todo lo posible para proporcionar una guía de migración gradual. From d7327b06d13401c83686df2a540f654ba291d8ec Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Alejandro=20Garc=C3=ADa=20Salas?= Date: Sat, 16 Feb 2019 11:08:11 -0800 Subject: [PATCH 10/14] Update faq-versioning.md --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index 165827227..d7c4f037e 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -40,7 +40,7 @@ En general, *no publicamos* una versión importante por cambios a: * **Advertencias de desarrollo.** Dado que no afectan el comportamiento en producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre versiones importantes. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios con rupturas. * **APIs que comienzan con `unstable_`.** Estos ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. -* **Versiones alfa y canarias de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características temprano, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. +* **Versiones alfa y canarias de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características temprano, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. Si utiliza estas versiones, tenga en cuenta que los APIs pueden cambiar antes de la versión estable sea publicada. * **APIs no documentadas y estructuras de datos internas.** Si accedes a nombres de propiedades internas como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Estás por tu cuenta. Esta política está diseñada para ser pragmática: desde luego, no queremos causarte dolores de cabeza. Si publicáramos una nueva versión importante por cada uno de estos cambios, acabaríamos lanzando más versiones importantes y causaríamos más inconvenientes con el versionado a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. From 7603dcce3d527c26bde568b6e8d4da3541ca917f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Alejandro=20Garc=C3=ADa=20Salas?= Date: Sat, 16 Feb 2019 11:09:38 -0800 Subject: [PATCH 11/14] Update faq-versioning.md --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index d7c4f037e..cd8a0e697 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -40,7 +40,7 @@ En general, *no publicamos* una versión importante por cambios a: * **Advertencias de desarrollo.** Dado que no afectan el comportamiento en producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre versiones importantes. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios con rupturas. * **APIs que comienzan con `unstable_`.** Estos ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. -* **Versiones alfa y canarias de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características temprano, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. Si utiliza estas versiones, tenga en cuenta que los APIs pueden cambiar antes de la versión estable sea publicada. +* **Versiones alfa y *canary* de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características con antelación, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. Si utiliza estas versiones, tenga en cuenta que los APIs pueden cambiar antes de la versión estable sea publicada. * **APIs no documentadas y estructuras de datos internas.** Si accedes a nombres de propiedades internas como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Estás por tu cuenta. Esta política está diseñada para ser pragmática: desde luego, no queremos causarte dolores de cabeza. Si publicáramos una nueva versión importante por cada uno de estos cambios, acabaríamos lanzando más versiones importantes y causaríamos más inconvenientes con el versionado a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. From 49cc53d1565fefa85a32cecd4c9f583ce622711d Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 11:13:54 -0800 Subject: [PATCH 12/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index cd8a0e697..1d7d8b774 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -39,7 +39,7 @@ Las advertencias de desarrollo no afectarán el comportamiento en tiempo de ejec En general, *no publicamos* una versión importante por cambios a: * **Advertencias de desarrollo.** Dado que no afectan el comportamiento en producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre versiones importantes. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios con rupturas. -* **APIs que comienzan con `unstable_`.** Estos ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. +* **APIs que comienzan con `unstable_`.** Estas ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. * **Versiones alfa y *canary* de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características con antelación, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. Si utiliza estas versiones, tenga en cuenta que los APIs pueden cambiar antes de la versión estable sea publicada. * **APIs no documentadas y estructuras de datos internas.** Si accedes a nombres de propiedades internas como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Estás por tu cuenta. From 4dafe8761c699555ff4aa561876ed78c43eb78db Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 11:18:48 -0800 Subject: [PATCH 13/14] Update content/docs/faq-versioning.md Co-Authored-By: alejandrogarciasalas --- content/docs/faq-versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index 1d7d8b774..d54803107 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -40,7 +40,7 @@ En general, *no publicamos* una versión importante por cambios a: * **Advertencias de desarrollo.** Dado que no afectan el comportamiento en producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre versiones importantes. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios con rupturas. * **APIs que comienzan con `unstable_`.** Estas ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. -* **Versiones alfa y *canary* de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características con antelación, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. Si utiliza estas versiones, tenga en cuenta que los APIs pueden cambiar antes de la versión estable sea publicada. +* **Versiones alfa y *canary* de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características con antelación, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. Si utilizas estas versiones, ten en cuenta que las APIs pueden cambiar antes de la versión estable sea publicada. * **APIs no documentadas y estructuras de datos internas.** Si accedes a nombres de propiedades internas como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Estás por tu cuenta. Esta política está diseñada para ser pragmática: desde luego, no queremos causarte dolores de cabeza. Si publicáramos una nueva versión importante por cada uno de estos cambios, acabaríamos lanzando más versiones importantes y causaríamos más inconvenientes con el versionado a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. From 5b7c3c93607a1ea908c096185ce9b123a4f49f3b Mon Sep 17 00:00:00 2001 From: Miguel Alejandro Bolivar Portilla Date: Sat, 16 Feb 2019 15:42:54 -0400 Subject: [PATCH 14/14] Update faq-versioning.md Fixing last 3 issues. --- content/docs/faq-versioning.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index d54803107..016e82b5e 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -32,17 +32,17 @@ Más de un millón de desarrolladores utilizan React, manteniendo colectivamente Las versiones de desarrollo de React incluyen muchas advertencias útiles. Siempre que es posible, añadimos advertencias en preparación a futuros cambios con rupturas. De esta manera, si tu aplicación no tiene advertencias en el último lanzamiento, esta será compatible con el próximo lanzamiento importante. Esto te permite actualizar tu aplicación un componente a la vez. -Las advertencias de desarrollo no afectarán el comportamiento en tiempo de ejecución de tu aplicación. De esa manera, puedes estar seguro de que tu aplicación se comportará de la misma manera entre la versión de desarrollo y la versión de producción -- las únicas diferencias son que la versión de producción no registrará las advertencias y es más eficiente. (Si alguna vez observas lo contrario, por favor abre un caso). +Las advertencias de desarrollo no afectarán el comportamiento en tiempo de ejecución de tu aplicación. De esa forma, puedes estar seguro de que tu aplicación se comportará de la misma manera entre la versión de desarrollo y la versión de producción -- las únicas diferencias son que la versión de producción no registrará las advertencias y es más eficiente. (Si alguna vez observas lo contrario, por favor abre un caso). ### ¿Qué cuenta como un Cambio con Rupturas? {#what-counts-as-a-breaking-change} En general, *no publicamos* una versión importante por cambios a: * **Advertencias de desarrollo.** Dado que no afectan el comportamiento en producción, podemos añadir nuevas advertencias o modificar advertencias existentes entre versiones importantes. De hecho, esto es lo que nos permite advertir de forma fiable sobre los próximos cambios con rupturas. -* **APIs que comienzan con `unstable_`.** Estas ofrecen funcionalidades experimentales sobre cuyos APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. +* **APIs que comienzan con `unstable_`.** Estas ofrecen funcionalidades experimentales sobre cuyas APIs todavía no estamos seguros. Al publicar esto con un prefijo `unstable_`, podemos iterar más rápido y llegar a un API estable lo antes posible. * **Versiones alfa y *canary* de React.** Proporcionamos versiones alfa de React como una manera de probar nuevas características con antelación, pero necesitamos la flexibilidad para hacer cambios basados en lo que aprendemos en el período alfa. Si utilizas estas versiones, ten en cuenta que las APIs pueden cambiar antes de la versión estable sea publicada. * **APIs no documentadas y estructuras de datos internas.** Si accedes a nombres de propiedades internas como `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, no podemos garantizar nada. Estás por tu cuenta. Esta política está diseñada para ser pragmática: desde luego, no queremos causarte dolores de cabeza. Si publicáramos una nueva versión importante por cada uno de estos cambios, acabaríamos lanzando más versiones importantes y causaríamos más inconvenientes con el versionado a la comunidad. También significaría que no podríamos mejorar React tan rápido como nos gustaría. -Dicho esto, si creemos que algún cambio en esta lista va a provocar grandes problemas en la comunidad, haremos todo lo posible para proporcionar una guía de migración gradual. +Dicho esto, si creemos que algún cambio en esta lista va a provocar grandes problemas en la comunidad, haremos todo lo posible para proporcionar una guía de actualización gradual.