From 819427f43bbdd87e4b2159410a109de99e36caf6 Mon Sep 17 00:00:00 2001 From: Salim Benfarhat Date: Thu, 7 Mar 2019 02:57:02 +0000 Subject: [PATCH 01/26] add first version translation faq-versioning.md --- content/docs/faq-versioning.md | 54 +++++++++++++++++++--------------- 1 file changed, 30 insertions(+), 24 deletions(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index b51ea4895..40a5eae2d 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -1,48 +1,54 @@ --- id: faq-versioning -title: Versioning Policy +title: Politique de gestion des versions permalink: docs/faq-versioning.html layout: docs category: FAQ --- -React follows [semantic versioning (semver)](https://semver.org/) principles. +React suit les principes de [sémantique de version (semver)](https://semver.org/lang/fr/). -That means that with a version number **x.y.z**: +Cela signifie qu'avec un numéro de version de type **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). +* Nous effectuons une ** version majeure ** en modifiant le nombre ** x ** (ex: 15.6.2 à 16.0.0), lors de la publication de ** dernières modifications **. +* Nous effectuons une ** version mineure ** en modifiant le nombre ** y ** (ex: 15.6.2 à 15.7.0), lors de la publication de ** nouvelles fonctionnalités **. +* Nous effectuons un ** version de correctif **, en modifiant le nombre ** z ** (ex: 15.6.2 to 15.6.3) lors de la publication de ** corrections de bugs **. -Major releases can also contain new features, and any release can include bug fixes. +Les versions majeures peuvent également contenir de nouvelles fonctionnalités, et toute version peut inclure des corrections de bugs. -### Breaking Changes {#breaking-changes} +### Dernières modifications {#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. +Les dernières modifications sont un inconvénient pour tout le monde. Nous essayons donc de réduire le nombre de versions majeures - par exemple, React 15 a été publié en avril 2016 et React 16 en septembre 2017; React 17 n'est pas prévu avant 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. +Et cela, du fait que nous publions les nouvelles fonctionnalités dans des versions mineures. Celles-ci sont souvent plus intéressantes et convaincantes que les majeures, malgré leur nom modeste. -### Commitment to Stability {#commitment-to-stability} +### Sélection des versions stable {#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. +À mesure que nous apportons des changements sur React au fil du temps, nous essayons de réduire les efforts requis afin de tirer parti des nouvelles fonctionnalités. Du moment que c'est possible, nous gardons une vieille API fonctionnelle. Et même si ça implique de la placer dans un paquet séparé. Par exemple, [les mixins sont découragés depuis des années] (/ blog / 2016/07/13 / mixins-Considered-dangerous.html) mais ils sont pris en charge à ce jour [via create-react-class] (/ docs / react -without-es6.html # mixins) et de nombreuses bases de code continuent de les utiliser dans du code stable et hérité. -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. +Plus d'un million de développeurs utilisent React, qui gère collectivement des millions de composants. La base de code de Facebook contient à elle seule plus de 50 000 composants React. +Cela signifie que nous devons faciliter au maximum la mise à niveau vers les nouvelles versions de React; Si nous apportons des modifications importantes sans passer par la migration, les utilisateurs resteront bloqués sur les anciennes versions. Nous testons ces chemins de mise à niveau sur Facebook même - si notre équipe de moins de 10 personnes peut mettre à jour plus de 50 000 composants à elle seule, nous espérons que la mise à niveau sera gérable pour toute personne utilisant React. Dans de nombreux cas, nous écrivons des [scripts automatisés] (https://github.com/reactjs/react-codemod) pour mettre à niveau la syntaxe du composant, que nous incluons ensuite dans la version du code source ouvert que chacun pourra utiliser. -### Gradual Upgrades via Warnings {#gradual-upgrades-via-warnings} +### Mises à niveau graduelles avec avertissements {#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. +Les versions de développement de React incluent de nombreux avertissements utiles. Dans la mesure du possible, nous ajoutons des avertissements en prévision de futurs changements radicaux. Ainsi, si votre application ne contient aucun avertissement sur la dernière version, elle sera compatible avec la prochaine version majeure. Cela vous permet de mettre à niveau vos applications composant par composant. -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.) +Les avertissements de développement n'affecteront pas le comportement d'exécution de votre application. De cette façon, vous pouvez être sûr que votre application se comportera de la même façon entre les versions de développement et de production. La seule différence est que la version de production n'enregistrera pas les avertissements et qu'elle sera plus efficace. (Si vous remarquez le contraire, veuillez déposer un problème.) -### What Counts as a Breaking Change? {#what-counts-as-a-breaking-change} +### Qu'est ce qui est comptabilisé pour dernières modifications? {#what-counts-as-a-breaking-change} -In general, we *don't* bump the major version number for changes to: +En général, nous *ne* supprimons *pas* le numéro de version majeur pour les modifications apportées à: + +* **Avertissements de développement.** Depuis que celles-ci n'affectent pas le comportement de production, nous pouvons ajouter de nouveaux avertissements ou modifier les avertissements existants entre les versions majeures. En fait, c’est ce qui nous permet, d’être averti de manière fiable, des changements à venir. In fact, this is what allows us to reliably warn about upcoming breaking changes. +* **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore sûrs des API dont nous avons confiance. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement et obtenir une API stable plus rapidement. +* **Versions alpha et canary de React.** +480/5000 +Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous avons appris au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. +* **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance $ uk43rzhitjg`, il n'y a aucune garantie. Tu es seul. + +Cette politique se veut pragmatique: nous ne voulons certainement pas vous causer de maux de tête. Si nous remplacions la version majeure par tous ces changements, nous finirions par publier de nouvelles versions majeures, ce qui causerait plus de problèmes à la communauté. Cela signifierait également que nous ne pouvons pas progresser dans l'amélioration de React aussi rapidement que nous le souhaiterions. + +Cela dit, si nous nous attendons à ce qu’un changement sur cette liste cause de gros problèmes dans la communauté, nous ferons tout notre possible pour fournir un chemin de migration graduel. -* **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. -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. -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. From 960b26d9dfa566434265f5c28c75e21ea6d6e76e Mon Sep 17 00:00:00 2001 From: Salim Benfarhat Date: Thu, 7 Mar 2019 03:03:57 +0000 Subject: [PATCH 02/26] add first version translation faq-versioning.md --- content/docs/faq-versioning.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index 40a5eae2d..677d1c09c 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -42,7 +42,6 @@ En général, nous *ne* supprimons *pas* le numéro de version majeur pour les m * **Avertissements de développement.** Depuis que celles-ci n'affectent pas le comportement de production, nous pouvons ajouter de nouveaux avertissements ou modifier les avertissements existants entre les versions majeures. En fait, c’est ce qui nous permet, d’être averti de manière fiable, des changements à venir. In fact, this is what allows us to reliably warn about upcoming breaking changes. * **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore sûrs des API dont nous avons confiance. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement et obtenir une API stable plus rapidement. * **Versions alpha et canary de React.** -480/5000 Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous avons appris au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. * **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance $ uk43rzhitjg`, il n'y a aucune garantie. Tu es seul. From f91a6fb732f813fe4d9b0510b207cc58a8382ffe Mon Sep 17 00:00:00 2001 From: Salim Benfarhat Date: Thu, 7 Mar 2019 03:12:07 +0000 Subject: [PATCH 03/26] add first version translation faq-versioning.md --- content/docs/faq-versioning.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index 677d1c09c..07488eac5 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -47,7 +47,4 @@ Nous fournissons des versions alpha de React afin de tester les nouvelles foncti Cette politique se veut pragmatique: nous ne voulons certainement pas vous causer de maux de tête. Si nous remplacions la version majeure par tous ces changements, nous finirions par publier de nouvelles versions majeures, ce qui causerait plus de problèmes à la communauté. Cela signifierait également que nous ne pouvons pas progresser dans l'amélioration de React aussi rapidement que nous le souhaiterions. -Cela dit, si nous nous attendons à ce qu’un changement sur cette liste cause de gros problèmes dans la communauté, nous ferons tout notre possible pour fournir un chemin de migration graduel. - - - +Cela dit, si nous nous attendons à ce qu’un changement sur cette liste cause de gros problèmes dans la communauté, nous ferons tout notre possible pour fournir un chemin de migration graduel. \ No newline at end of file From 7ceb63da627e607a2a74403e9c79cf12b7acdec2 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:01:08 +0100 Subject: [PATCH 04/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- content/docs/faq-versioning.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index 07488eac5..c1ffb7d71 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -6,7 +6,7 @@ layout: docs category: FAQ --- -React suit les principes de [sémantique de version (semver)](https://semver.org/lang/fr/). +React suit les principes de [gestion sémantique de version (semver)](https://semver.org/lang/fr/). Cela signifie qu'avec un numéro de version de type **x.y.z**: @@ -47,4 +47,4 @@ Nous fournissons des versions alpha de React afin de tester les nouvelles foncti Cette politique se veut pragmatique: nous ne voulons certainement pas vous causer de maux de tête. Si nous remplacions la version majeure par tous ces changements, nous finirions par publier de nouvelles versions majeures, ce qui causerait plus de problèmes à la communauté. Cela signifierait également que nous ne pouvons pas progresser dans l'amélioration de React aussi rapidement que nous le souhaiterions. -Cela dit, si nous nous attendons à ce qu’un changement sur cette liste cause de gros problèmes dans la communauté, nous ferons tout notre possible pour fournir un chemin de migration graduel. \ No newline at end of file +Cela dit, si nous nous attendons à ce qu’un changement sur cette liste cause de gros problèmes dans la communauté, nous ferons tout notre possible pour fournir un chemin de migration graduel. From 12a5728773d2fb368a7c681de35eb81ae46f9d3a Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:01:25 +0100 Subject: [PATCH 05/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 c1ffb7d71..28a1694e3 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -8,7 +8,7 @@ category: FAQ React suit les principes de [gestion sémantique de version (semver)](https://semver.org/lang/fr/). -Cela signifie qu'avec un numéro de version de type **x.y.z**: +Ça signifie qu'avec un numéro de version de type **x.y.z** : * Nous effectuons une ** version majeure ** en modifiant le nombre ** x ** (ex: 15.6.2 à 16.0.0), lors de la publication de ** dernières modifications **. * Nous effectuons une ** version mineure ** en modifiant le nombre ** y ** (ex: 15.6.2 à 15.7.0), lors de la publication de ** nouvelles fonctionnalités **. From 83f097b97872c24f140a7a1d6d76b5d54e8af327 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:02:24 +0100 Subject: [PATCH 06/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 28a1694e3..eb2888b2d 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -10,7 +10,7 @@ React suit les principes de [gestion sémantique de version (semver)](https://se Ça signifie qu'avec un numéro de version de type **x.y.z** : -* Nous effectuons une ** version majeure ** en modifiant le nombre ** x ** (ex: 15.6.2 à 16.0.0), lors de la publication de ** dernières modifications **. +* Pour publier des **modifications cassant la compatibilité ascendante**, nous changeons de **version majeure** en modifiant le nombre **x** (ex. 15.6.2 à 16.0.0). * Nous effectuons une ** version mineure ** en modifiant le nombre ** y ** (ex: 15.6.2 à 15.7.0), lors de la publication de ** nouvelles fonctionnalités **. * Nous effectuons un ** version de correctif **, en modifiant le nombre ** z ** (ex: 15.6.2 to 15.6.3) lors de la publication de ** corrections de bugs **. From 322952ec2c190e355b6dd5613ab1ea139de262cf Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:02:39 +0100 Subject: [PATCH 07/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 eb2888b2d..96c3a7806 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -11,7 +11,7 @@ React suit les principes de [gestion sémantique de version (semver)](https://se Ça signifie qu'avec un numéro de version de type **x.y.z** : * Pour publier des **modifications cassant la compatibilité ascendante**, nous changeons de **version majeure** en modifiant le nombre **x** (ex. 15.6.2 à 16.0.0). -* Nous effectuons une ** version mineure ** en modifiant le nombre ** y ** (ex: 15.6.2 à 15.7.0), lors de la publication de ** nouvelles fonctionnalités **. +* Pour publier des **nouvelles fonctionnalités**, nous changeons de **version mineure** en modifiant le nombre **y** (ex. 15.6.2 à 15.7.0). * Nous effectuons un ** version de correctif **, en modifiant le nombre ** z ** (ex: 15.6.2 to 15.6.3) lors de la publication de ** corrections de bugs **. Les versions majeures peuvent également contenir de nouvelles fonctionnalités, et toute version peut inclure des corrections de bugs. From d8269cd9e81cee168a3e51fefbcc1e2a3b773fa2 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:02:56 +0100 Subject: [PATCH 08/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 96c3a7806..e46269e21 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -12,7 +12,7 @@ React suit les principes de [gestion sémantique de version (semver)](https://se * Pour publier des **modifications cassant la compatibilité ascendante**, nous changeons de **version majeure** en modifiant le nombre **x** (ex. 15.6.2 à 16.0.0). * Pour publier des **nouvelles fonctionnalités**, nous changeons de **version mineure** en modifiant le nombre **y** (ex. 15.6.2 à 15.7.0). -* Nous effectuons un ** version de correctif **, en modifiant le nombre ** z ** (ex: 15.6.2 to 15.6.3) lors de la publication de ** corrections de bugs **. +* Pour publier des **corrections de bugs**, nous changeons de **version de correctif** en modifiant le nombre **z** (ex. 15.6.2 à 15.6.3). Les versions majeures peuvent également contenir de nouvelles fonctionnalités, et toute version peut inclure des corrections de bugs. From fc490877086b7c5b766426393cdee83b19a3a65d Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:03:14 +0100 Subject: [PATCH 09/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 e46269e21..8a7ce3193 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -40,7 +40,7 @@ Les avertissements de développement n'affecteront pas le comportement d'exécut En général, nous *ne* supprimons *pas* le numéro de version majeur pour les modifications apportées à: * **Avertissements de développement.** Depuis que celles-ci n'affectent pas le comportement de production, nous pouvons ajouter de nouveaux avertissements ou modifier les avertissements existants entre les versions majeures. En fait, c’est ce qui nous permet, d’être averti de manière fiable, des changements à venir. In fact, this is what allows us to reliably warn about upcoming breaking changes. -* **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore sûrs des API dont nous avons confiance. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement et obtenir une API stable plus rapidement. +* **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore satisfaits de leurs API. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement dessus et obtenir une API stable plus tôt. * **Versions alpha et canary de React.** Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous avons appris au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. * **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance $ uk43rzhitjg`, il n'y a aucune garantie. Tu es seul. From 0badf4e5e8e92a6e41acd611b15b5dca632675ab Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:03:29 +0100 Subject: [PATCH 10/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 8a7ce3193..7327b27b4 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -42,7 +42,7 @@ En général, nous *ne* supprimons *pas* le numéro de version majeur pour les m * **Avertissements de développement.** Depuis que celles-ci n'affectent pas le comportement de production, nous pouvons ajouter de nouveaux avertissements ou modifier les avertissements existants entre les versions majeures. En fait, c’est ce qui nous permet, d’être averti de manière fiable, des changements à venir. In fact, this is what allows us to reliably warn about upcoming breaking changes. * **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore satisfaits de leurs API. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement dessus et obtenir une API stable plus tôt. * **Versions alpha et canary de React.** -Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous avons appris au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. +Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous apprenons au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. * **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance $ uk43rzhitjg`, il n'y a aucune garantie. Tu es seul. Cette politique se veut pragmatique: nous ne voulons certainement pas vous causer de maux de tête. Si nous remplacions la version majeure par tous ces changements, nous finirions par publier de nouvelles versions majeures, ce qui causerait plus de problèmes à la communauté. Cela signifierait également que nous ne pouvons pas progresser dans l'amélioration de React aussi rapidement que nous le souhaiterions. From 703f2c80f7a6ba0ee6a362e846a0623334450220 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:03:46 +0100 Subject: [PATCH 11/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 7327b27b4..260f57604 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -16,7 +16,7 @@ React suit les principes de [gestion sémantique de version (semver)](https://se Les versions majeures peuvent également contenir de nouvelles fonctionnalités, et toute version peut inclure des corrections de bugs. -### Dernières modifications {#breaking-changes} +### Ruptures de compatibilité ascendante {#breaking-changes} Les dernières modifications sont un inconvénient pour tout le monde. Nous essayons donc de réduire le nombre de versions majeures - par exemple, React 15 a été publié en avril 2016 et React 16 en septembre 2017; React 17 n'est pas prévu avant 2019. From 6433b30426b80e1099da56b9739b3c3268e5d458 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:03:54 +0100 Subject: [PATCH 12/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 260f57604..7908b6faf 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -43,7 +43,7 @@ En général, nous *ne* supprimons *pas* le numéro de version majeur pour les m * **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore satisfaits de leurs API. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement dessus et obtenir une API stable plus tôt. * **Versions alpha et canary de React.** Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous apprenons au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. -* **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance $ uk43rzhitjg`, il n'y a aucune garantie. Tu es seul. +* **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance $ uk43rzhitjg`, il n'y a aucune garantie. Débrouillez-vous. Cette politique se veut pragmatique: nous ne voulons certainement pas vous causer de maux de tête. Si nous remplacions la version majeure par tous ces changements, nous finirions par publier de nouvelles versions majeures, ce qui causerait plus de problèmes à la communauté. Cela signifierait également que nous ne pouvons pas progresser dans l'amélioration de React aussi rapidement que nous le souhaiterions. From a8fe9ada968dc9ff5a29ecbfbfa16696a79473b5 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:04:08 +0100 Subject: [PATCH 13/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 7908b6faf..7e6c527fb 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -18,7 +18,7 @@ Les versions majeures peuvent également contenir de nouvelles fonctionnalités, ### Ruptures de compatibilité ascendante {#breaking-changes} -Les dernières modifications sont un inconvénient pour tout le monde. Nous essayons donc de réduire le nombre de versions majeures - par exemple, React 15 a été publié en avril 2016 et React 16 en septembre 2017; React 17 n'est pas prévu avant 2019. +Personne n’aime perdre en compatibilité ascendante, nous essayons donc de minimiser le nombre de versions majeures ; par exemple, React 15 est sorti en avril 2016 et React 16 en septembre 2017 ; React 17 n'est pas prévu avant 2019. Et cela, du fait que nous publions les nouvelles fonctionnalités dans des versions mineures. Celles-ci sont souvent plus intéressantes et convaincantes que les majeures, malgré leur nom modeste. From d80b2c162d08357320a7679e94bf93ce420106d4 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:04:31 +0100 Subject: [PATCH 14/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 7e6c527fb..a37359ee8 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -45,6 +45,6 @@ En général, nous *ne* supprimons *pas* le numéro de version majeur pour les m Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous apprenons au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. * **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance $ uk43rzhitjg`, il n'y a aucune garantie. Débrouillez-vous. -Cette politique se veut pragmatique: nous ne voulons certainement pas vous causer de maux de tête. Si nous remplacions la version majeure par tous ces changements, nous finirions par publier de nouvelles versions majeures, ce qui causerait plus de problèmes à la communauté. Cela signifierait également que nous ne pouvons pas progresser dans l'amélioration de React aussi rapidement que nous le souhaiterions. +Cette politique se veut pragmatique : nous ne voulons évidemment pas vous causer de maux de tête. Si nous élevions la version majeure pour tous ces changements, nous finirions par publier plus de versions majeures, ce qui s'avèrerait plus pénible pour la communauté. Ça signifierait également que nous ne pourrions pas améliorer React aussi rapidement que nous le souhaiterions. Cela dit, si nous nous attendons à ce qu’un changement sur cette liste cause de gros problèmes dans la communauté, nous ferons tout notre possible pour fournir un chemin de migration graduel. From 9c4b9147652c876ced39455be9b8fea2bb8788fe Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:04:56 +0100 Subject: [PATCH 15/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 a37359ee8..b15ead0b1 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -20,7 +20,7 @@ Les versions majeures peuvent également contenir de nouvelles fonctionnalités, Personne n’aime perdre en compatibilité ascendante, nous essayons donc de minimiser le nombre de versions majeures ; par exemple, React 15 est sorti en avril 2016 et React 16 en septembre 2017 ; React 17 n'est pas prévu avant 2019. -Et cela, du fait que nous publions les nouvelles fonctionnalités dans des versions mineures. Celles-ci sont souvent plus intéressantes et convaincantes que les majeures, malgré leur nom modeste. +Au lieu de ça, nous publions les nouvelles fonctionnalités dans des versions mineures. Celles-ci sont souvent plus intéressantes et motivantes que les majeures, malgré leur nom modeste. ### Sélection des versions stable {#commitment-to-stability} From 20158efd7c373d58551fac2a28a559bd3a557885 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:05:07 +0100 Subject: [PATCH 16/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 b15ead0b1..0d29e083b 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -22,7 +22,7 @@ Personne n’aime perdre en compatibilité ascendante, nous essayons donc de min Au lieu de ça, nous publions les nouvelles fonctionnalités dans des versions mineures. Celles-ci sont souvent plus intéressantes et motivantes que les majeures, malgré leur nom modeste. -### Sélection des versions stable {#commitment-to-stability} +### Nos engagements en termes de stabilité {#commitment-to-stability} À mesure que nous apportons des changements sur React au fil du temps, nous essayons de réduire les efforts requis afin de tirer parti des nouvelles fonctionnalités. Du moment que c'est possible, nous gardons une vieille API fonctionnelle. Et même si ça implique de la placer dans un paquet séparé. Par exemple, [les mixins sont découragés depuis des années] (/ blog / 2016/07/13 / mixins-Considered-dangerous.html) mais ils sont pris en charge à ce jour [via create-react-class] (/ docs / react -without-es6.html # mixins) et de nombreuses bases de code continuent de les utiliser dans du code stable et hérité. From 692c8a12debb457f553c6017c932c17cd0fe32c7 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:05:17 +0100 Subject: [PATCH 17/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 0d29e083b..45256bb8c 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -24,7 +24,7 @@ Au lieu de ça, nous publions les nouvelles fonctionnalités dans des versions m ### Nos engagements en termes de stabilité {#commitment-to-stability} -À mesure que nous apportons des changements sur React au fil du temps, nous essayons de réduire les efforts requis afin de tirer parti des nouvelles fonctionnalités. Du moment que c'est possible, nous gardons une vieille API fonctionnelle. Et même si ça implique de la placer dans un paquet séparé. Par exemple, [les mixins sont découragés depuis des années] (/ blog / 2016/07/13 / mixins-Considered-dangerous.html) mais ils sont pris en charge à ce jour [via create-react-class] (/ docs / react -without-es6.html # mixins) et de nombreuses bases de code continuent de les utiliser dans du code stable et hérité. +À mesure que nous améliorons React, nous essayons d'abaisser la barrière d'entrée pour tirer parti des nouvelles fonctionnalités. Chaque fois que possible, nous continuons à prendre en charge une vieille API, même si ça implique de la placer dans un module séparé. Par exemple, [les mixins sont découragés depuis des années](/blog/2016/07/13/mixins-considered-harmful.html) mais ils restent pris en charge à ce jour [via create-react-class](/docs/react-without-es6.html#mixins) et de nombreuses bases de code continuent de les utiliser dans du code historique stable. Plus d'un million de développeurs utilisent React, qui gère collectivement des millions de composants. La base de code de Facebook contient à elle seule plus de 50 000 composants React. Cela signifie que nous devons faciliter au maximum la mise à niveau vers les nouvelles versions de React; Si nous apportons des modifications importantes sans passer par la migration, les utilisateurs resteront bloqués sur les anciennes versions. Nous testons ces chemins de mise à niveau sur Facebook même - si notre équipe de moins de 10 personnes peut mettre à jour plus de 50 000 composants à elle seule, nous espérons que la mise à niveau sera gérable pour toute personne utilisant React. Dans de nombreux cas, nous écrivons des [scripts automatisés] (https://github.com/reactjs/react-codemod) pour mettre à niveau la syntaxe du composant, que nous incluons ensuite dans la version du code source ouvert que chacun pourra utiliser. From f515e62cca02e480302fb24864ba3494995e405c Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:05:33 +0100 Subject: [PATCH 18/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 45256bb8c..e3ee39304 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -26,7 +26,7 @@ Au lieu de ça, nous publions les nouvelles fonctionnalités dans des versions m À mesure que nous améliorons React, nous essayons d'abaisser la barrière d'entrée pour tirer parti des nouvelles fonctionnalités. Chaque fois que possible, nous continuons à prendre en charge une vieille API, même si ça implique de la placer dans un module séparé. Par exemple, [les mixins sont découragés depuis des années](/blog/2016/07/13/mixins-considered-harmful.html) mais ils restent pris en charge à ce jour [via create-react-class](/docs/react-without-es6.html#mixins) et de nombreuses bases de code continuent de les utiliser dans du code historique stable. -Plus d'un million de développeurs utilisent React, qui gère collectivement des millions de composants. La base de code de Facebook contient à elle seule plus de 50 000 composants React. +Plus d'un million de développeurs utilisent React, qui maintiennent collectivement des millions de composants. La base de code de Facebook contient à elle seule plus de 50 000 composants React. Cela signifie que nous devons faciliter au maximum la mise à niveau vers les nouvelles versions de React; Si nous apportons des modifications importantes sans passer par la migration, les utilisateurs resteront bloqués sur les anciennes versions. Nous testons ces chemins de mise à niveau sur Facebook même - si notre équipe de moins de 10 personnes peut mettre à jour plus de 50 000 composants à elle seule, nous espérons que la mise à niveau sera gérable pour toute personne utilisant React. Dans de nombreux cas, nous écrivons des [scripts automatisés] (https://github.com/reactjs/react-codemod) pour mettre à niveau la syntaxe du composant, que nous incluons ensuite dans la version du code source ouvert que chacun pourra utiliser. ### Mises à niveau graduelles avec avertissements {#gradual-upgrades-via-warnings} From 08d123a47bc3f423aefc3314d99c2bc132b60788 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:05:43 +0100 Subject: [PATCH 19/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 e3ee39304..6128b63ca 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -27,7 +27,7 @@ Au lieu de ça, nous publions les nouvelles fonctionnalités dans des versions m À mesure que nous améliorons React, nous essayons d'abaisser la barrière d'entrée pour tirer parti des nouvelles fonctionnalités. Chaque fois que possible, nous continuons à prendre en charge une vieille API, même si ça implique de la placer dans un module séparé. Par exemple, [les mixins sont découragés depuis des années](/blog/2016/07/13/mixins-considered-harmful.html) mais ils restent pris en charge à ce jour [via create-react-class](/docs/react-without-es6.html#mixins) et de nombreuses bases de code continuent de les utiliser dans du code historique stable. Plus d'un million de développeurs utilisent React, qui maintiennent collectivement des millions de composants. La base de code de Facebook contient à elle seule plus de 50 000 composants React. -Cela signifie que nous devons faciliter au maximum la mise à niveau vers les nouvelles versions de React; Si nous apportons des modifications importantes sans passer par la migration, les utilisateurs resteront bloqués sur les anciennes versions. Nous testons ces chemins de mise à niveau sur Facebook même - si notre équipe de moins de 10 personnes peut mettre à jour plus de 50 000 composants à elle seule, nous espérons que la mise à niveau sera gérable pour toute personne utilisant React. Dans de nombreux cas, nous écrivons des [scripts automatisés] (https://github.com/reactjs/react-codemod) pour mettre à niveau la syntaxe du composant, que nous incluons ensuite dans la version du code source ouvert que chacun pourra utiliser. +Ça signifie que nous devons faciliter au maximum la mise à niveau vers les nouvelles versions de React ; si nous apportons des modifications importantes sans fournir d’aide à la migration, les utilisateurs resteront bloqués sur les anciennes versions. Nous testons ces approches de mise à niveau sur Facebook même : si notre équipe de moins de 10 personnes peut mettre à jour plus de 50 000 composants à elle seule, nous espérons que la mise à niveau sera gérable pour toute personne utilisant React. Dans de nombreux cas, nous écrivons des [scripts automatisés](https://github.com/reactjs/react-codemod) pour mettre à niveau la syntaxe des composants, que nous incluons ensuite dans la version libre de notre code source pour que chacun·e puisse les utiliser. ### Mises à niveau graduelles avec avertissements {#gradual-upgrades-via-warnings} From b9ace9759f0d6cce90d19a8e10c2ddf96bb782dc Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:05:53 +0100 Subject: [PATCH 20/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 6128b63ca..7f9aed02c 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -29,7 +29,7 @@ Au lieu de ça, nous publions les nouvelles fonctionnalités dans des versions m Plus d'un million de développeurs utilisent React, qui maintiennent collectivement des millions de composants. La base de code de Facebook contient à elle seule plus de 50 000 composants React. Ça signifie que nous devons faciliter au maximum la mise à niveau vers les nouvelles versions de React ; si nous apportons des modifications importantes sans fournir d’aide à la migration, les utilisateurs resteront bloqués sur les anciennes versions. Nous testons ces approches de mise à niveau sur Facebook même : si notre équipe de moins de 10 personnes peut mettre à jour plus de 50 000 composants à elle seule, nous espérons que la mise à niveau sera gérable pour toute personne utilisant React. Dans de nombreux cas, nous écrivons des [scripts automatisés](https://github.com/reactjs/react-codemod) pour mettre à niveau la syntaxe des composants, que nous incluons ensuite dans la version libre de notre code source pour que chacun·e puisse les utiliser. -### Mises à niveau graduelles avec avertissements {#gradual-upgrades-via-warnings} +### Mises à niveau progressives grâce aux avertissements {#gradual-upgrades-via-warnings} Les versions de développement de React incluent de nombreux avertissements utiles. Dans la mesure du possible, nous ajoutons des avertissements en prévision de futurs changements radicaux. Ainsi, si votre application ne contient aucun avertissement sur la dernière version, elle sera compatible avec la prochaine version majeure. Cela vous permet de mettre à niveau vos applications composant par composant. From b231a65f148935942577fa1438527530338dacb1 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:06:04 +0100 Subject: [PATCH 21/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 7f9aed02c..c7505ef3a 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -31,7 +31,7 @@ Plus d'un million de développeurs utilisent React, qui maintiennent collectivem ### Mises à niveau progressives grâce aux avertissements {#gradual-upgrades-via-warnings} -Les versions de développement de React incluent de nombreux avertissements utiles. Dans la mesure du possible, nous ajoutons des avertissements en prévision de futurs changements radicaux. Ainsi, si votre application ne contient aucun avertissement sur la dernière version, elle sera compatible avec la prochaine version majeure. Cela vous permet de mettre à niveau vos applications composant par composant. +Les versions de développement de React incluent de nombreux avertissements utiles. Dans la mesure du possible, nous ajoutons des avertissements en prévision de futurs changements radicaux. Ainsi, si votre application ne contient aucun avertissement sur la dernière version, elle sera compatible avec la prochaine version majeure. Ça vous permet de mettre à niveau vos applications composant par composant. Les avertissements de développement n'affecteront pas le comportement d'exécution de votre application. De cette façon, vous pouvez être sûr que votre application se comportera de la même façon entre les versions de développement et de production. La seule différence est que la version de production n'enregistrera pas les avertissements et qu'elle sera plus efficace. (Si vous remarquez le contraire, veuillez déposer un problème.) From e387240942ec2e8cc5b5c72877b1c3cb156bc70f Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:06:19 +0100 Subject: [PATCH 22/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 c7505ef3a..212de63cf 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -33,7 +33,7 @@ Plus d'un million de développeurs utilisent React, qui maintiennent collectivem Les versions de développement de React incluent de nombreux avertissements utiles. Dans la mesure du possible, nous ajoutons des avertissements en prévision de futurs changements radicaux. Ainsi, si votre application ne contient aucun avertissement sur la dernière version, elle sera compatible avec la prochaine version majeure. Ça vous permet de mettre à niveau vos applications composant par composant. -Les avertissements de développement n'affecteront pas le comportement d'exécution de votre application. De cette façon, vous pouvez être sûr que votre application se comportera de la même façon entre les versions de développement et de production. La seule différence est que la version de production n'enregistrera pas les avertissements et qu'elle sera plus efficace. (Si vous remarquez le contraire, veuillez déposer un problème.) +Les avertissements de développement n'affecteront pas le comportement d'exécution de votre application. De cette façon, vous pouvez être sûr·e que votre application se comportera de la même façon entre les versions de développement et de production. La seule différence, c’est que la version de production n'émettra pas les avertissements et qu'elle sera plus efficace. (Si vous remarquez le contraire, veuillez créer une *issue* dans le dépôt GitHub.) ### Qu'est ce qui est comptabilisé pour dernières modifications? {#what-counts-as-a-breaking-change} From 21eadf72154281870f2f2ae372002f69c77ce2c8 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:06:34 +0100 Subject: [PATCH 23/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 212de63cf..3b6c1eee0 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -35,7 +35,7 @@ Les versions de développement de React incluent de nombreux avertissements util Les avertissements de développement n'affecteront pas le comportement d'exécution de votre application. De cette façon, vous pouvez être sûr·e que votre application se comportera de la même façon entre les versions de développement et de production. La seule différence, c’est que la version de production n'émettra pas les avertissements et qu'elle sera plus efficace. (Si vous remarquez le contraire, veuillez créer une *issue* dans le dépôt GitHub.) -### Qu'est ce qui est comptabilisé pour dernières modifications? {#what-counts-as-a-breaking-change} +### Qu'est ce qui constitue une rupture de compatibilité ? {#what-counts-as-a-breaking-change} En général, nous *ne* supprimons *pas* le numéro de version majeur pour les modifications apportées à: From 26102722ccb1b27d38c56261205af36d6b9926f6 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:06:43 +0100 Subject: [PATCH 24/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 3b6c1eee0..99a9477b9 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -37,7 +37,7 @@ Les avertissements de développement n'affecteront pas le comportement d'exécut ### Qu'est ce qui constitue une rupture de compatibilité ? {#what-counts-as-a-breaking-change} -En général, nous *ne* supprimons *pas* le numéro de version majeur pour les modifications apportées à: +En général, nous *n’élevons pas* le numéro de version majeure pour les modifications apportées aux aspects suivants : * **Avertissements de développement.** Depuis que celles-ci n'affectent pas le comportement de production, nous pouvons ajouter de nouveaux avertissements ou modifier les avertissements existants entre les versions majeures. En fait, c’est ce qui nous permet, d’être averti de manière fiable, des changements à venir. In fact, this is what allows us to reliably warn about upcoming breaking changes. * **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore satisfaits de leurs API. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement dessus et obtenir une API stable plus tôt. From 7f3bc80ea1cc80a5f6c865e53d90ec1ae5511875 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:06:52 +0100 Subject: [PATCH 25/26] Update content/docs/faq-versioning.md Co-Authored-By: salimbenfarhat --- 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 99a9477b9..cc3b6abf7 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -39,7 +39,7 @@ Les avertissements de développement n'affecteront pas le comportement d'exécut En général, nous *n’élevons pas* le numéro de version majeure pour les modifications apportées aux aspects suivants : -* **Avertissements de développement.** Depuis que celles-ci n'affectent pas le comportement de production, nous pouvons ajouter de nouveaux avertissements ou modifier les avertissements existants entre les versions majeures. En fait, c’est ce qui nous permet, d’être averti de manière fiable, des changements à venir. In fact, this is what allows us to reliably warn about upcoming breaking changes. +* **Avertissements de développement.** Dans la mesure où ils n'affectent pas le comportement de production, nous nous réservons le droit d’ajouter de nouveaux avertissements ou de modifier les avertissements existants entre les versions majeures. En fait, c’est ce qui nous permet de vous avertir de manière fiable des changements à venir. * **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore satisfaits de leurs API. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement dessus et obtenir une API stable plus tôt. * **Versions alpha et canary de React.** Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous apprenons au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. From 9f274013a81cbd68685239465a91a5672261845e Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Wed, 13 Mar 2019 17:40:09 +0100 Subject: [PATCH 26/26] Final tweaks --- content/docs/faq-versioning.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/faq-versioning.md b/content/docs/faq-versioning.md index cc3b6abf7..efce05cce 100644 --- a/content/docs/faq-versioning.md +++ b/content/docs/faq-versioning.md @@ -1,6 +1,6 @@ --- id: faq-versioning -title: Politique de gestion des versions +title: Politique de gestion des versions permalink: docs/faq-versioning.html layout: docs category: FAQ @@ -14,11 +14,11 @@ React suit les principes de [gestion sémantique de version (semver)](https://se * Pour publier des **nouvelles fonctionnalités**, nous changeons de **version mineure** en modifiant le nombre **y** (ex. 15.6.2 à 15.7.0). * Pour publier des **corrections de bugs**, nous changeons de **version de correctif** en modifiant le nombre **z** (ex. 15.6.2 à 15.6.3). -Les versions majeures peuvent également contenir de nouvelles fonctionnalités, et toute version peut inclure des corrections de bugs. +Les versions majeures peuvent également contenir de nouvelles fonctionnalités, et toute version peut inclure des corrections de bugs. ### Ruptures de compatibilité ascendante {#breaking-changes} -Personne n’aime perdre en compatibilité ascendante, nous essayons donc de minimiser le nombre de versions majeures ; par exemple, React 15 est sorti en avril 2016 et React 16 en septembre 2017 ; React 17 n'est pas prévu avant 2019. +Personne n’aime perdre en compatibilité ascendante, nous essayons donc de minimiser le nombre de versions majeures ; par exemple, React 15 est sorti en avril 2016 et React 16 en septembre 2017 ; React 17 n'est pas prévu avant 2019. Au lieu de ça, nous publions les nouvelles fonctionnalités dans des versions mineures. Celles-ci sont souvent plus intéressantes et motivantes que les majeures, malgré leur nom modeste. @@ -33,7 +33,7 @@ Plus d'un million de développeurs utilisent React, qui maintiennent collectivem Les versions de développement de React incluent de nombreux avertissements utiles. Dans la mesure du possible, nous ajoutons des avertissements en prévision de futurs changements radicaux. Ainsi, si votre application ne contient aucun avertissement sur la dernière version, elle sera compatible avec la prochaine version majeure. Ça vous permet de mettre à niveau vos applications composant par composant. -Les avertissements de développement n'affecteront pas le comportement d'exécution de votre application. De cette façon, vous pouvez être sûr·e que votre application se comportera de la même façon entre les versions de développement et de production. La seule différence, c’est que la version de production n'émettra pas les avertissements et qu'elle sera plus efficace. (Si vous remarquez le contraire, veuillez créer une *issue* dans le dépôt GitHub.) +Les avertissements de développement n'affecteront pas le comportement d'exécution de votre application. De cette façon, vous pouvez être sûr·e que votre application se comportera de la même façon entre les versions de développement et de production. La seule différence, c’est que la version de production n'émettra pas les avertissements et qu'elle sera plus efficace. (Si vous remarquez le contraire, veuillez créer une *issue* dans le dépôt GitHub.) ### Qu'est ce qui constitue une rupture de compatibilité ? {#what-counts-as-a-breaking-change} @@ -41,10 +41,10 @@ En général, nous *n’élevons pas* le numéro de version majeure pour les mod * **Avertissements de développement.** Dans la mesure où ils n'affectent pas le comportement de production, nous nous réservons le droit d’ajouter de nouveaux avertissements ou de modifier les avertissements existants entre les versions majeures. En fait, c’est ce qui nous permet de vous avertir de manière fiable des changements à venir. * **API commençant par `unstable_`.** Celles-ci sont fournies en tant que fonctionnalités expérimentales et nous ne sommes pas encore satisfaits de leurs API. En les publiant avec un préfixe `unstable_`, nous pouvons itérer plus rapidement dessus et obtenir une API stable plus tôt. -* **Versions alpha et canary de React.** +* **Versions alpha et canary de React.** Nous fournissons des versions alpha de React afin de tester les nouvelles fonctionnalités à un stade précoce, mais nous avons besoin de la souplesse nécessaire pour apporter des modifications en fonction de ce que nous apprenons au cours de la période alpha. Si vous utilisez ces versions, notez que les API peuvent changer avant la version stable. -* **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance $ uk43rzhitjg`, il n'y a aucune garantie. Débrouillez-vous. +* **API non documentées et structures de données internes.** Si vous accédez à des noms de propriété internes tels que `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` ou` __reactInternalInstance$uk43rzhitjg`, il n'y a aucune garantie. Débrouillez-vous. Cette politique se veut pragmatique : nous ne voulons évidemment pas vous causer de maux de tête. Si nous élevions la version majeure pour tous ces changements, nous finirions par publier plus de versions majeures, ce qui s'avèrerait plus pénible pour la communauté. Ça signifierait également que nous ne pourrions pas améliorer React aussi rapidement que nous le souhaiterions. -Cela dit, si nous nous attendons à ce qu’un changement sur cette liste cause de gros problèmes dans la communauté, nous ferons tout notre possible pour fournir un chemin de migration graduel. +Cela dit, si nous nous attendons à ce qu’un changement sur cette liste cause de gros problèmes dans la communauté, nous ferons tout notre possible pour fournir un chemin de migration progressif.