Skip to content

Commit

Permalink
feat: apply review changes to guides/upgrading/index.md
Browse files Browse the repository at this point in the history
  • Loading branch information
BlueCutOfficial committed Jul 23, 2024
1 parent a062af5 commit f179f6d
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 9 deletions.
2 changes: 1 addition & 1 deletion .local.dic
Original file line number Diff line number Diff line change
Expand Up @@ -375,7 +375,6 @@ reader/nombrable
readme
README
readonly
release/nombrable
recognizers
record/nombrable
Redux
Expand All @@ -385,6 +384,7 @@ refresh
registry
relationship/nombrable
relayout
release/nombrable
reload
renderer
rendering
Expand Down
16 changes: 8 additions & 8 deletions guides/upgrading/index.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
Quand des devs disent qu'ils "mettent à jour" leur app Ember, ça peut vouloir dire plusieurs choses, en particulier s'ils parlent de "passer à Octane". Cette page du Guide vous aidera à remplir les blancs sur ce qui concerne la mise à jour la version de votre app, l'accès aux dernières et meilleures fonctionnalités, et à définir une stratégie pour utiliser les fonctionnalités d'Octane dans vos apps existantes.
Quand quelqu'un vous dit qu'il ou elle "met à jour" leur app Ember, ça peut vouloir dire plusieurs choses, en particulier s'il s'agit de "passer à Octane". Cette page du Guide vous aidera à remplir les blancs sur ce qui concerne la mise à jour de la version de votre app, l'accès aux dernières et meilleures fonctionnalités, et à définir une stratégie pour utiliser les fonctionnalités d'Octane dans vos apps existantes.

## Détail des _releases_ récentes
## Détail des dernières version

Vous apprendrez ce qui a changé dans chaque _release_ (version livrée) en lisant [le blog officiel d'Ember](https://blog.emberjs.com).
Pour connaître les changements apportés par chaque version (_release_), reportez-vous au [blog officiel d'Ember](https://blog.emberjs.com).

## Mises à jour de routine pour maintenir les versions mineures

Mettons que vous voulez mettre à jour une app de `v3.4` à `v3.8`. Bien que vous ayez entendu parler de nouvelles fonctionnalités, votre objectif principal est de suivre les mises à jour de sécurité. Pour faire ce type de mise à jour, suivez les instructions [ici, dans les Guides CLI](https://cli.emberjs.com/release/basic-use/upgrading/). Ce processus vous assurera que toutes les dépendances de la base de code `ember.js` sont également mises à jour. Des outils automatisés vous aideront à faire les bons changements dans le `package.json` et d'autres fichiers. L'intérêt d'un saut de version mineure est que vous ne devriez pas avoir besoin de changer quoi que ce soit dans votre application lors de la mise à jour ; tout devrait continuer à fonctionner, que vous choisissiez ou non d'adopter de nouvelles syntaxes et fonctionnalités.
Mettons que vous voulez mettre à jour une app de `v3.4` à `v3.8`. Bien que vous ayez entendu parler de nouvelles fonctionnalités, votre objectif principal est de suivre les mises à jour de sécurité. Pour faire ce type de mise à jour, suivez les instructions [ici, dans le Guide CLI](https://cli.emberjs.com/release/basic-use/upgrading/). Ce processus vous assurera que toutes les dépendances de la base de code `ember.js` sont également mises à jour. Des outils automatisés vous aideront à faire les bons changements dans le `package.json` et d'autres fichiers. L'intérêt d'un saut de version mineure est que vous ne devriez pas avoir besoin de changer quoi que ce soit dans votre application lors de la mise à jour ; tout devrait continuer à fonctionner, que vous choisissiez ou non d'adopter de nouvelles syntaxes et fonctionnalités.

## Utiliser de nouvelles fonctionnalités

Une fois que vous avez mis à jour la version d'une app, de nouvelles fonctionnalités peuvent parfois être disponibles d'emblée. En revanche, d'autres fonctionnalités nécessitent que vous les activiez spécifiquement dans la configuration de votre app, car elles peuvent modifier son comportement par défaut.
Une fois que vous avez mis à jour la version d'une app, de nouvelles fonctionnalités prêtes à l'emploi peuvent parfois être disponibles. En revanche, d'autres fonctionnalités nécessitent que vous les activiez spécifiquement dans la configuration de votre app, car il est possible qu'elles puissent modifier son comportement par défaut.

<!-- spell ignore -->
La meilleure manière de découvrir les nouvelles fonctionnalités est de lire les [articles de blog sur les _releases_](https://blog.emberjs.com/tags/releases.html). Une nouvelle fonctionnalité qui requiert que vous l'activiez est appelée fonctionnalité optionnelle (_optional feature_). Suivez [le guide des fonctionnalités optionnelles](../configuring-ember/optional-features/) pour savoir lesquelles sont disponibles dans la version d'Ember de votre app, et comment les activer. Dans de nombreux cas, des _codemods_ seront disponibles pour vous aider à faire des mises à jour liées à la syntaxe. Un _codemod_ est un outil qui réécrit votre code existant dans une nouvelle syntaxe. Lorsqu'ils sont disponibles, ils peuvent vous épargner beaucoup de temps passé à faire des modifications à la main.
La meilleure manière de découvrir les nouvelles fonctionnalités est de lire les [articles de blog sur les _releases_](https://blog.emberjs.com/tags/releases.html). Une nouvelle fonctionnalité qui requiert que vous l'activiez est appelée fonctionnalité optionnelle (_optional feature_). Suivez [le guide des fonctionnalités optionnelles](../configuring-ember/optional-features/) pour savoir lesquelles sont disponibles dans la version d'Ember de votre app, et comment les activer. Dans de nombreux cas, des _codemods_ seront disponibles pour vous aider à faire des mises à jour liées à la syntaxe. Un _codemod_ est un outil qui réécrit votre code actuel dans une nouvelle syntaxe. Lorsqu'ils sont disponibles, ils peuvent vous épargner beaucoup de temps passé à faire des modifications à la main.

## Gérer les dépréciations

Si une API que vous utiliser doit être supprimée dans la prochaine version majeure d'Ember, vous verrez un message de dépréciation (_deprecation warning_) dans la console de développement. Ces messages pourront parfois être causés par le code de votre app, et d'autres fois, par celui d'un addon.

Pour en savoir plus sur la manière dont gérer les dépréciations, lisez la page [Gérer les dépréciations](../configuring-ember/handling-deprecations/), jetez un œil [aux outils de gestion des dépréciations](../ember-inspector/deprecations/) de l'Ember Inspector, ou regardez les [_Deprecations Guides_](https://deprecations.emberjs.com/).
Pour en savoir plus sur la manière de gérer les dépréciations, lisez la page [Gérer les dépréciations](../configuring-ember/handling-deprecations/), jetez un œil [aux outils de gestion des dépréciations](../ember-inspector/deprecations/) de l'Ember Inspector, ou regardez les [_Deprecations Guides_](https://deprecations.emberjs.com/).


## Mettre à jour vers Octane

Octane a été un grand pas en avant dans la syntaxe, les fonctionnalités, et les modèles mentaux d'Ember&nbsp;! Si vous êtes dans le processus de mettre à jour une app existante vers Octane, jetez un œil à la page dédiée [Guide de Mise à Jour vers Octane](./current-edition/).
Octane a été un grand pas en avant dans la syntaxe, les fonctionnalités, et les modèles mentaux d'Ember&nbsp;! Si vous êtes en train de mettre à jour une app existante vers Octane, jetez un œil à la page dédiée [Guide de Mise à Jour vers Octane](./current-edition/).

0 comments on commit f179f6d

Please sign in to comment.