docs/fr-FR/breaking_changes.md

   1 # Breaking changes
   2
   3 Ce document décrit le processus de QMK pour la gestion des breaking changes. Un breaking change est un changement qui modifie la manière dont QMK fonctionne introduisant des incompatibilités ou des comportements dangereux. Nous limitons ces changements afin que les utilisateurs n'aient pas peur de casser leurs keymaps en mettant à jour leur version de QMK.
   4
   5 La période de breaking change est quand nous allons fusionner un PR qui change QMK d'une manière dangereuse ou inattendue. Il y a une période interne de test afin de nous assurer que les problèmes résiduels sont rares ou impossible à prévoir.
   6
   7 ## Qu'est-ce qui a été inclus dans des Breaking Changes précédents?
   8
   9 * [30 août 2019](ChangeLog/20190830.md)
  10
  11 ## Quand va être le prochain Breaking Change?
  12
  13 Le prochain Breaking Change est planifié pour le 29 novembre.
  14
  15 ### Dates importantes
  16
  17 * [x] 21 septembre 2019 - `future` est créé. Il va être rebasé de manière hebdomadaire.
  18 * [ ] 01 novembre 2019 - `future` fermé aux nouveaux PRs.
  19 * [ ] 01 novembre 2019 - Appel aux testeurs.
  20 * [ ] 27 novembre 2019 - `master` est bloqué, pas de PRs fusionnés.
  21 * [ ] 29 novembre 2019 - `future` est fusionné dans `master`.
  22 * [ ] 30 novembre 2019 - `master` est débloqué. Les PRs peuvent à nouveau être fusionnés.
  23
  24 ## Quels changements seront inclus?
  25
  26 Pour voir une liste de candidats de breaking changes, vous pouvez regardez la liste des [labels `breaking_change`](https://github.com/qmk/qmk_firmware/pulls?q=is%3Aopen+label%3Abreaking_change+is%3Apr). De nouveaux changements peuvent être ajoutés entre maintenant et lorsque `future` est fermée, et un PR avec ce label n'est pas garanti d'être fusionné.
  27
  28 Si vous souhaitez que votre breaking change soit inclus dans ce tour, vous devez créer un PR avec le label `breaking_change` et faire en sorte qu'il soit accepté avant que `future` ne soit fermé. Une fois `future` fermé, aucun nouveau breaking change sera accepté.
  29
  30 Critère d'acceptation:
  31
  32 * Le PR est complété et prêt à fusionner
  33 * Le PR a un ChangeLog
  34
  35 # Checklists
  36
  37 Cette section documente plusieurs processus que nous utilisons en lançant le processus de Breaking Change.
  38
  39 ## Rebase `future` de `master`
  40
  41 Ceci est lancé chaque vendredi tant que `future` est ouvert.
  42
  43 Processus:
  44
  45 ```
  46 cd qmk_firmware
  47 git checkout master
  48 git pull --ff-only
  49 git checkout future
  50 git rebase master
  51 git push --force
  52 ```
  53
  54 ## Créer la branche `future`
  55
  56 Ceci est fait immédiatement après la fusion de la branche `future` précédente.
  57
  58 * `qmk_firmware` git commands
  59     * [ ] `git checkout master`
  60     * [ ] `git pull --ff-only`
  61     * [ ] `git checkout -b future`
  62     * [ ] Modifie `readme.md`
  63         * [ ] Ajoute un message en haut qui indique que c'est une branche de test.
  64         * [ ] Ajoute un lien vers ce document
  65     * [ ] `git commit -m 'Branch point for <DATE> Breaking Change'`
  66     * [ ] `git tag breakpoint_<YYYY>_<MM>_<DD>`
  67     * [ ] `git tag <next_version>` # Evite que le label point d'arrêt soit confondu par un incrément de version
  68     * [ ] `git push origin future`
  69     * [ ] `git push --tags`
  70
  71 ## 4 Semaines Avant la Fusion
  72
  73 * `future` est maintenant fermé aux nouveaux PRs, seul des correctifs pour les PRs courants peuvent être mergés
  74 * Envoi de l'appel aux testeurs
  75     * [ ] Discord
  76     * [ ] GitHub PR
  77     * [ ] https://reddit.com/r/olkb
  78
  79 ## 1 Semaine Avant la Fusion
  80
  81 * Annonce que master sera fermée entre <2 jours avant> à <Jour de la fusion>
  82     * [ ] Discord
  83     * [ ] GitHub PR
  84     * [ ] https://reddit.com/r/olkb
  85
  86 ## 2 Jours Avant la Fusion
  87
  88 * Annonce que master est fermé pour 2 jours
  89     * [ ] Discord
  90     * [ ] GitHub PR
  91     * [ ] https://reddit.com/r/olkb
  92
  93 ## Jour de la fusion
  94
  95 * `qmk_firmware` git commands
  96     * [ ] `git checkout future`
  97     * [ ] `git pull --ff-only`
  98     * [ ] `git rebase origin/master`
  99     * [ ] Modifie `readme.md`
 100         * [ ] Supprimer les notes à propos de `future`
 101     * [ ] Regroupe ChangeLog dans un fichier.
 102     * [ ] `git commit -m 'Merge point for <DATE> Breaking Change'`
 103     * [ ] `git push origin future`
 104 * Actions sur Github
 105     * [ ] Crée un PR pour `future`
 106     * [ ] S'assurer que Travis ne relève aucun problème
 107     * [ ] Fusion le PR `future`