aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorXavier Hahn <xavier.hahn@gmail.com>2019-10-10 00:45:41 +0200
committernoroadsleft <18669334+noroadsleft@users.noreply.github.com>2019-10-09 15:45:41 -0700
commitda3ff89fac34117400bd19f0da8ac8b420827c15 (patch)
tree952581145f071c047de7aaad4e0f508703c77ca8 /docs
parente58343596af5f749c5bc07aab3a897c6b6b5ac99 (diff)
downloadqmk_firmware-da3ff89fac34117400bd19f0da8ac8b420827c15.tar.gz
qmk_firmware-da3ff89fac34117400bd19f0da8ac8b420827c15.zip
[Docs] French translation - Breaking Changes section (#6966)
* Translated breaking_changes.md in French * Translated ChangeLog/20190830.md to French * Update docs/fr-FR/breaking_changes.md Co-Authored-By: Max Rumpf <max.rumpf1998@gmail.com> * Fix comments from @zekth Co-Authored-By: Vincent LE GOFF <g_n_s@hotmail.fr>
Diffstat (limited to 'docs')
-rw-r--r--docs/fr-FR/ChangeLog/20190830.md52
-rw-r--r--docs/fr-FR/_summary.md6
-rw-r--r--docs/fr-FR/breaking_changes.md107
3 files changed, 162 insertions, 3 deletions
diff --git a/docs/fr-FR/ChangeLog/20190830.md b/docs/fr-FR/ChangeLog/20190830.md
new file mode 100644
index 000000000..4ce1b0863
--- /dev/null
+++ b/docs/fr-FR/ChangeLog/20190830.md
@@ -0,0 +1,52 @@
1# QMK Breaking Change - 30 août 2019
2
3Quatre fois par an, QMK lance un processus pour fusionner les 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 n'effectuons ces changements que 4 fois par an afin que les utilisateurs n'aient pas peur de casser leurs keymaps en mettant à jour leur version de QMK.
4
5Ce document présente les fusions de Breaking Change. Voici la liste des changements.
6
7## Formattage de code Core avec clang-format
8
9* Tous les fichiers core (`drivers/`, `quantum/`, `tests/`, et `tmk_core/`) seront formattés avec clang-format
10* Un processus travis pour reformatter les PRs lors de la fusion a été mis en place
11* Vous pouvez utiliser la nouvelle commande CLI `qmk cformat` afin de formatter avant de soumettre votre PR si vous le souhaitez.
12
13## Nettoyage des descripteurs LUFA USB
14
15* Nettoyage du code lié aux descripteurs USB HID sur les claviers AVR, afin de les rendre plus simple à lire et compréhensibles
16* Plus d'information: https://github.com/qmk/qmk_firmware/pull/4871
17* Normalement pas de changement de fonctionnement et aucune keymap modifiée.
18
19## Migration des entrées de `ACTION_LAYER_MOMENTARY()` dans `fn_actions` vers des keycodes `MO()`
20
21* `fn_actions` est déprécié, et ses fonctionnalités ont été remplacées par des keycodes directs et `process_record_user()`
22* Supprimer cette fonctionnalité obsolète devrait aboutir à une réduction importante de la taille du firmware et de la complexité du code
23* Il est recommandé que toutes les keymaps affectées remplacent `fn_actions` vers les fonctionnalités de [keycode custom](https://docs.qmk.fm/#/custom_quantum_functions) et [macro](https://docs.qmk.fm/#/feature_macros)
24
25## Mise à jour Atreus vers les conventions de codage courantes
26
27* Les doublons include guards ont contourné le comportement de traitement des headers attendu
28* Il est recommandé pour toutes les keymaps affectées de supprimer le doublon de `<keyboard>/config.h` et `<keyboard>/keymaps/<user>/config.h` et de ne garder que des surcharges au niveau keymap
29
30## Récupération des changements de fichier keymap langage de la fork ZSA
31
32* Corrige une issue dans le fichier `keymap_br_abnt2.h` qui inclut la mauvaise souce (`keymap_common.h` au lieu de `keymap.h`)
33* Met à jour le fichier `keymap_swedish.h` afin d'être spécifique au suédois et plus "nordique" en général.
34* Toutes les keymaps qui utilisent ceci devront supprimer `NO_*` et le remplacer par `SE_*`.
35
36## Mise à jour du repo afin d'utiliser LUFA comme un sous-module git
37
38* `/lib/LUFA` supprimé du dépôt
39* LUFA, définis comme un sous-module, pointe vers qmk/lufa
40* Ceci devrait ajouter plus de flexibilité vers LUFA, et nous permet de garder le sous-module à jour bien plus facilement. Il avait environ 2 ans de retard, sans manière simple de corriger. Ce changement devrait simplifier la mise à jour dans le futur.
41
42## Migration des entrées `ACTION_BACKLIGHT_*()` dans `fn_actions` vers des keycodes `BL_`
43
44* `fn_actions` est déprécié, et ses fonctionnalités ont été remplacées par des keycodes directs et `process_record_user()`
45* Toutes les keymaps utilisant ces actions doivent avoir les clés `KC_FN*` remplacées par les clés `BL_*` équivalentes
46* Si vous utilisez actuellement `KC_FN*` vous devrez remplacer `fn_actions` avec les fonctionnalités de [keycode custom](https://docs.qmk.fm/#/custom_quantum_functions) et [macro](https://docs.qmk.fm/#/feature_macros)
47
48## Remplacer l'alias `KC_DELT` par `KC_DEL`
49
50* `KC_DELT` était un alias redondant et non documenté pour `KC_DELETE`
51* Il a été supprimé et toutes ses utilisations ont été remplacées par l'alias plus courant `KC_DEL`
52* Environ 90 keymaps (surtout des boards ErgoDox) ont été modifiées à cette fin
diff --git a/docs/fr-FR/_summary.md b/docs/fr-FR/_summary.md
index 204f03aab..16ae82d06 100644
--- a/docs/fr-FR/_summary.md
+++ b/docs/fr-FR/_summary.md
@@ -16,10 +16,10 @@
16 * [Comment utiliser GitHub](fr-FR/getting_started_github.md) 16 * [Comment utiliser GitHub](fr-FR/getting_started_github.md)
17 * [Trouver de l'aide](fr-FR/getting_started_getting_help.md) 17 * [Trouver de l'aide](fr-FR/getting_started_getting_help.md)
18 18
19**En Anglais** 19* [Breaking changes](fr-FR/breaking_changes.md)
20 * [30 août 2019](fr-FR/ChangeLog/20190830.md)
20 21
21* [Changements non rétro-compatibles](breaking_changes.md) 22**En Anglais**
22 * [30 Aout 2019](ChangeLog/20190830.md)
23 23
24* [FAQ](faq.md) 24* [FAQ](faq.md)
25 * [FAQ Générale](faq_general.md) 25 * [FAQ Générale](faq_general.md)
diff --git a/docs/fr-FR/breaking_changes.md b/docs/fr-FR/breaking_changes.md
new file mode 100644
index 000000000..6913dbd3f
--- /dev/null
+++ b/docs/fr-FR/breaking_changes.md
@@ -0,0 +1,107 @@
1# Breaking changes
2
3Ce 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
5La 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
13Le 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
26Pour 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
28Si 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
30Critère d'acceptation:
31
32* Le PR est complété et prêt à fusionner
33* Le PR a un ChangeLog
34
35# Checklists
36
37Cette section documente plusieurs processus que nous utilisons en lançant le processus de Breaking Change.
38
39## Rebase `future` de `master`
40
41Ceci est lancé chaque vendredi tant que `future` est ouvert.
42
43Processus:
44
45```
46cd qmk_firmware
47git checkout master
48git pull --ff-only
49git checkout future
50git rebase master
51git push --force
52```
53
54## Créer la branche `future`
55
56Ceci 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`