From c74e9e834730d1df7bedc23d2e249fe2822c63c7 Mon Sep 17 00:00:00 2001 From: Kushal Agrawal <98145879+kushal34712@users.noreply.github.com> Date: Sat, 21 Oct 2023 16:54:02 +0530 Subject: [PATCH 1/6] Create maintainer_guide.french.md --- .../maintainer_guide.french.md | 74 +++++++++++++++++++ 1 file changed, 74 insertions(+) create mode 100644 translations/maintainer_guide/maintainer_guide.french.md diff --git a/translations/maintainer_guide/maintainer_guide.french.md b/translations/maintainer_guide/maintainer_guide.french.md new file mode 100644 index 000000000..ec3effeeb --- /dev/null +++ b/translations/maintainer_guide/maintainer_guide.french.md @@ -0,0 +1,74 @@ +# Guide du responsable + +Ce guide est destiné à ceux qui souhaitent rejoindre le projet en tant que responsables, pour aider à gérer et maintenir le projet pour la communauté. (Ceci n'est pas un guide pour les **contributeurs débutants**) + +## Traductions + +Ce tutoriel est également disponible en [autres langues](translations/README.md) + +| [English](maintainer_guide.md) | [Bangla](translations/maintainer_guide/maintainer_guide.ben.md) | [Chinese (Traditional)](/translations/maintainer_guide/maintainer_guide.zho-tc.md) | [German](translations/maintainer_guide/maintainer_guide.ger.md) | [Hindi](translations/maintainer_guide/maintainer_guide.hin.md) | +| :---: | :---: | :---: | :---: | :---: | +| [Italian](translations/maintainer_guide/maintainer_guide.ita.md) | [Japanese](translations/maintainer_guide/maintainer_guide.jpn.md) | [Portuguese](translations/maintainer_guide/maintainer_guide.por.md) | [Ukrainian](/translations/maintainer_guide/maintainer_guide.ukr.md) | + + +> Les traductions des documentations de projets sont les bienvenues. Lire [`Guide de traduction`](translations/README.md)contribuer. + +--- + +## Objectifs + +Notre objectif principal est de donner à nos contributeurs le feedback le plus rapide possible à partir du moment où ils font leur pull request. Cela signifie principalement procéder à des révisions de code et fusionner les PR acceptés. +En dehors de cela, nous pouvons maintenir le projet en nous assurant que tout fonctionne correctement et aussi utile que possible pour nos contributeurs. + +## C'est pour qui ? + +Toute personne possédant un peu de compétences en Git et GitHub. Vous n'avez pas besoin d'être un expert, ce guide devrait aider même les débutants. Il s'agit d'un projet actif qui reçoit des contributions régulières et qui aide de nombreuses personnes à apporter leur première contribution open source. Être responsable de ce projet permet de garantir qu'il continue à offrir à nos contributeurs une bonne première expérience et de les encourager à contribuer davantage. + +Vous pouvez y consacrer autant ou aussi peu de temps que vous le souhaitez. Entre nous, nous espérons que tout se passera bien. + +## Méthodologie + +- Accédez à la section pull request du projet, commencez par la pull request la plus ancienne qui n'est pas dans l'état « modifications demandées ». +- Ouvrez un PR et accédez à l'onglet Modifications des fichiers et lancez une révision du code. +- Vérifiez le PR, assurez-vous qu'il suit les spécifications du didacticiel. +- Assurez-vous que le HTML, les liens et les données sont tous corrects. Assurez-vous que la carte est positionnée au début du fichier là où elle devrait être. +- Vérifiez ensuite tout conflit. Fusionnez « master » dans la branche PR pour résoudre les conflits. Les conflits surviennent généralement lorsqu'un certain temps s'est écoulé depuis les fusions précédentes et que plusieurs PR utilisent la même version obsolète. +- Si tel est le cas, résolvez le conflit. Habituellement, vous devrez ajouter la nouvelle carte au-dessus des cartes qui ont été ajoutées depuis la création du fork. +- Si tout le reste va bien, approuvez le PR, écrivez un message au contributeur pour le remercier pour sa contribution (en vous rappelant qu'il s'agit d'un premier venu et qu'il bénéficierait d'encouragements). +- Fusionnez le PR dans `master`. + +## Demander des modifications + +- Parfois, il y a des problèmes avec le PR qui devraient être résolus par le contributeur, comme une mauvaise branche, un code HTML cassé, des informations manquantes, une carte placée au mauvais endroit. Tout ce où le tutoriel n'a pas été suivi correctement (et pas de simples conflits de fusion). +- Démarrez une révision de code sur GitHub et demandez des modifications. Essayez d'être aussi descriptif que possible, commentez la ligne exacte, dites-leur exactement quel est le problème et comment le résoudre, et encouragez-les sur le fait qu'il s'agit d'une partie normale du processus d'examen des relations publiques. +- Lorsque vous êtes prêt, soumettez votre avis. +- Gardez un œil sur la conversation au cas où le contributeur aurait des questions complémentaires pour lesquelles vous pourriez l'aider. Notre objectif est d’amener tout le monde à franchir la ligne d’arrivée, c’est pourquoi nous essayons de les guider jusqu’au bout. +- Une fois qu'ils ont corrigé les modifications demandées, le PR peut être fusionné avec « maître ». +- Veuillez toujours vérifier que les modifications n'ont pas interrompu le projet et que la page en direct fonctionne toujours comme prévu. Il est toujours préférable de tester les modifications localement avant de fusionner et de ne jamais fusionner quoi que ce soit qui semble suspect. + +## Outils + +S'il n'y a pas beaucoup de PR accumulés, tout ce processus peut être effectué directement dans la page GitHub du projet. +Cependant, il n'est pas rare d'avoir quelques PR en attente et c'est alors qu'il y aura inévitablement des conflits de fusion. Vous pouvez utiliser tous les outils que vous connaissez pour voir les différences et résoudre les conflits. +I recommend the use of a tool like [GitKraken](https://www.gitkraken.com/download). C'est visuel et cela permet une gestion plus facile du projet lorsqu'il y a quelques PR à réaliser. +Téléchargez GitKraken, clonez le projet. L'utilisation d'une combinaison de votre éditeur de code et de l'outil de conflit de fusion intégré de GitKraken vous donne un contrôle total pour parcourir rapidement les PR, résoudre les conflits et fusionner. + +Le projet a installé Prettier pour garantir que quelle que soit la manière dont un contributeur soumet le PR, le guide de style sera appliqué. Le projet de cette façon est toujours maintenu avec la même indentation et le même style. +Si vous remarquez que le fichier HTML semble désordonné, exécutez le code ci-dessous à la racine du projet. + +```js +npx plus joli --write index.html +``` + +Il devrait essayer de formater le fichier et s'il n'y parvient pas, il vous montrera les erreurs. Parfois, une balise de fermeture manquante ou un code HTML cassé est fusionné par erreur et c'est un bon moyen de le repérer et de le corriger. + +Si jamais vous avez des doutes, vous pouvez toujours me mentionner ou mentionner les autres responsables dans le PR lui-même ou m'envoyer un message privé sur [Twitter](https://twitter.com/Syknapse). + +## Rejoignez-nous + +Rejoignez-nous pour contribuer à faire grandir ce projet ensemble. Contactez-moi au [Twitter](https://twitter.com/Syknapse) et envoyez-moi votre nom d'utilisateur GitHub pour que je puisse vous ajouter. Vous pouvez également rejoindre notre communauté Discord en cliquant sur le bouton ci-dessous : + +[![Discord](https://badgen.net/discord/online-members/tWkvS4ueVF?label=Join%20Our%20Discord%20Server&icon=discord)](https://discord.gg/tWkvS4ueVF 'Join our Discord server!') + +##Merci + From be1b84595b271552de460755a49571e4e7f48578 Mon Sep 17 00:00:00 2001 From: Kushal Agrawal <98145879+kushal34712@users.noreply.github.com> Date: Sun, 22 Oct 2023 11:09:45 +0530 Subject: [PATCH 2/6] Update maintainer_guide.fre.md --- translations/maintainer_guide/maintainer_guide.french.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/maintainer_guide/maintainer_guide.french.md b/translations/maintainer_guide/maintainer_guide.french.md index ec3effeeb..5e481dd33 100644 --- a/translations/maintainer_guide/maintainer_guide.french.md +++ b/translations/maintainer_guide/maintainer_guide.french.md @@ -70,5 +70,5 @@ Rejoignez-nous pour contribuer à faire grandir ce projet ensemble. Contactez-mo [![Discord](https://badgen.net/discord/online-members/tWkvS4ueVF?label=Join%20Our%20Discord%20Server&icon=discord)](https://discord.gg/tWkvS4ueVF 'Join our Discord server!') -##Merci + From 69f692fc596e46dfe624e3d263b458defd31b258 Mon Sep 17 00:00:00 2001 From: Kushal Agrawal <98145879+kushal34712@users.noreply.github.com> Date: Wed, 25 Oct 2023 15:01:15 +0530 Subject: [PATCH 3/6] Update and rename maintainer_guide.french.md to maintainer_guide.fra.md --- .../{maintainer_guide.french.md => maintainer_guide.fra.md} | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) rename translations/maintainer_guide/{maintainer_guide.french.md => maintainer_guide.fra.md} (98%) diff --git a/translations/maintainer_guide/maintainer_guide.french.md b/translations/maintainer_guide/maintainer_guide.fra.md similarity index 98% rename from translations/maintainer_guide/maintainer_guide.french.md rename to translations/maintainer_guide/maintainer_guide.fra.md index 5e481dd33..796112b57 100644 --- a/translations/maintainer_guide/maintainer_guide.french.md +++ b/translations/maintainer_guide/maintainer_guide.fra.md @@ -10,8 +10,7 @@ Ce tutoriel est également disponible en [autres langues](translations/README.md | :---: | :---: | :---: | :---: | :---: | | [Italian](translations/maintainer_guide/maintainer_guide.ita.md) | [Japanese](translations/maintainer_guide/maintainer_guide.jpn.md) | [Portuguese](translations/maintainer_guide/maintainer_guide.por.md) | [Ukrainian](/translations/maintainer_guide/maintainer_guide.ukr.md) | - -> Les traductions des documentations de projets sont les bienvenues. Lire [`Guide de traduction`](translations/README.md)contribuer. +> Les traductions des documentations de projets sont les bienvenues. Lire [`Guide de traduction`](../README.md)contribuer. --- From 1e9956b48ba8021c781b08c90a746269b539abb9 Mon Sep 17 00:00:00 2001 From: Kushal Agrawal <98145879+kushal34712@users.noreply.github.com> Date: Wed, 25 Oct 2023 15:09:19 +0530 Subject: [PATCH 4/6] Update maintainer_guide.fra.md --- translations/maintainer_guide/maintainer_guide.fra.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/translations/maintainer_guide/maintainer_guide.fra.md b/translations/maintainer_guide/maintainer_guide.fra.md index 796112b57..f7e8ada48 100644 --- a/translations/maintainer_guide/maintainer_guide.fra.md +++ b/translations/maintainer_guide/maintainer_guide.fra.md @@ -6,9 +6,9 @@ Ce guide est destiné à ceux qui souhaitent rejoindre le projet en tant que res Ce tutoriel est également disponible en [autres langues](translations/README.md) -| [English](maintainer_guide.md) | [Bangla](translations/maintainer_guide/maintainer_guide.ben.md) | [Chinese (Traditional)](/translations/maintainer_guide/maintainer_guide.zho-tc.md) | [German](translations/maintainer_guide/maintainer_guide.ger.md) | [Hindi](translations/maintainer_guide/maintainer_guide.hin.md) | +| [English](/maintainer_guide.md) | [Bangla](/translations/maintainer_guide/maintainer_guide.ben.md) | [Chinese (Traditional)](/translations/maintainer_guide/maintainer_guide.zho-tc.md) | [German](/translations/maintainer_guide/maintainer_guide.ger.md) | [Hindi](/translations/maintainer_guide/maintainer_guide.hin.md) | | :---: | :---: | :---: | :---: | :---: | -| [Italian](translations/maintainer_guide/maintainer_guide.ita.md) | [Japanese](translations/maintainer_guide/maintainer_guide.jpn.md) | [Portuguese](translations/maintainer_guide/maintainer_guide.por.md) | [Ukrainian](/translations/maintainer_guide/maintainer_guide.ukr.md) | +| [Italian](/translations/maintainer_guide/maintainer_guide.ita.md) | [Japanese](/translations/maintainer_guide/maintainer_guide.jpn.md) | [Portuguese](/translations/maintainer_guide/maintainer_guide.por.md) | [Ukrainian](/translations/maintainer_guide/maintainer_guide.ukr.md) | > Les traductions des documentations de projets sont les bienvenues. Lire [`Guide de traduction`](../README.md)contribuer. From eda6b9e3479a1f1f190b5d1f9899e777a2159ae7 Mon Sep 17 00:00:00 2001 From: Kushal Agrawal <98145879+kushal34712@users.noreply.github.com> Date: Wed, 25 Oct 2023 15:16:38 +0530 Subject: [PATCH 5/6] Update maintainer_guide.fra.md --- translations/maintainer_guide/maintainer_guide.fra.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/translations/maintainer_guide/maintainer_guide.fra.md b/translations/maintainer_guide/maintainer_guide.fra.md index f7e8ada48..a671e1a8c 100644 --- a/translations/maintainer_guide/maintainer_guide.fra.md +++ b/translations/maintainer_guide/maintainer_guide.fra.md @@ -6,11 +6,11 @@ Ce guide est destiné à ceux qui souhaitent rejoindre le projet en tant que res Ce tutoriel est également disponible en [autres langues](translations/README.md) -| [English](/maintainer_guide.md) | [Bangla](/translations/maintainer_guide/maintainer_guide.ben.md) | [Chinese (Traditional)](/translations/maintainer_guide/maintainer_guide.zho-tc.md) | [German](/translations/maintainer_guide/maintainer_guide.ger.md) | [Hindi](/translations/maintainer_guide/maintainer_guide.hin.md) | +| [English](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/maintainer_guide.md) | [Bangla]([/translations/maintainer_guide/maintainer_guide.ben.md](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.ben.md)) | [Chinese (Traditional)](/translations/maintainer_guide/maintainer_guide.zho-tc.md) | [German]([/translations/maintainer_guide/maintainer_guide.ger.md](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.ger.md)) | [Hindi]([/translations/maintainer_guide/maintainer_guide.hin.md](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.hin.md)) | | :---: | :---: | :---: | :---: | :---: | -| [Italian](/translations/maintainer_guide/maintainer_guide.ita.md) | [Japanese](/translations/maintainer_guide/maintainer_guide.jpn.md) | [Portuguese](/translations/maintainer_guide/maintainer_guide.por.md) | [Ukrainian](/translations/maintainer_guide/maintainer_guide.ukr.md) | +| [Italian]([/translations/maintainer_guide/maintainer_guide.ita.md](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.ita.md) | [Japanese](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.jpn.md) | [Portuguese](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.por.md) | [Ukrainian](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.ukr.md) | -> Les traductions des documentations de projets sont les bienvenues. Lire [`Guide de traduction`](../README.md)contribuer. +> Les traductions des documentations de projets sont les bienvenues. Lire [`Guide de traduction`](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/README.md)contribuer. --- From 5fc5febf8097b206fbc6b707e797283232cc38cc Mon Sep 17 00:00:00 2001 From: Mehedi Hasan <103281314+TenTraicion@users.noreply.github.com> Date: Wed, 25 Oct 2023 23:00:00 +0600 Subject: [PATCH 6/6] Apply suggestions from code review --- .../maintainer_guide/maintainer_guide.fra.md | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/translations/maintainer_guide/maintainer_guide.fra.md b/translations/maintainer_guide/maintainer_guide.fra.md index a671e1a8c..40ba05d64 100644 --- a/translations/maintainer_guide/maintainer_guide.fra.md +++ b/translations/maintainer_guide/maintainer_guide.fra.md @@ -4,13 +4,9 @@ Ce guide est destiné à ceux qui souhaitent rejoindre le projet en tant que res ## Traductions -Ce tutoriel est également disponible en [autres langues](translations/README.md) +Ce tutoriel est également disponible en [autres langues](../README.md) -| [English](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/maintainer_guide.md) | [Bangla]([/translations/maintainer_guide/maintainer_guide.ben.md](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.ben.md)) | [Chinese (Traditional)](/translations/maintainer_guide/maintainer_guide.zho-tc.md) | [German]([/translations/maintainer_guide/maintainer_guide.ger.md](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.ger.md)) | [Hindi]([/translations/maintainer_guide/maintainer_guide.hin.md](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.hin.md)) | -| :---: | :---: | :---: | :---: | :---: | -| [Italian]([/translations/maintainer_guide/maintainer_guide.ita.md](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.ita.md) | [Japanese](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.jpn.md) | [Portuguese](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.por.md) | [Ukrainian](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/maintainer_guide/maintainer_guide.ukr.md) | - -> Les traductions des documentations de projets sont les bienvenues. Lire [`Guide de traduction`](https://github.com/Syknapse/Contribute-To-This-Project/blob/69f692fc596e46dfe624e3d263b458defd31b258/translations/README.md)contribuer. +> Les traductions des documentations de projets sont les bienvenues. Lire [`Guide de traduction`](../README.md) contribuer. --- @@ -31,7 +27,7 @@ Vous pouvez y consacrer autant ou aussi peu de temps que vous le souhaitez. Entr - Ouvrez un PR et accédez à l'onglet Modifications des fichiers et lancez une révision du code. - Vérifiez le PR, assurez-vous qu'il suit les spécifications du didacticiel. - Assurez-vous que le HTML, les liens et les données sont tous corrects. Assurez-vous que la carte est positionnée au début du fichier là où elle devrait être. -- Vérifiez ensuite tout conflit. Fusionnez « master » dans la branche PR pour résoudre les conflits. Les conflits surviennent généralement lorsqu'un certain temps s'est écoulé depuis les fusions précédentes et que plusieurs PR utilisent la même version obsolète. +- Vérifiez ensuite tout conflit. Fusionnez `master` dans la branche PR pour résoudre les conflits. Les conflits surviennent généralement lorsqu'un certain temps s'est écoulé depuis les fusions précédentes et que plusieurs PR utilisent la même version obsolète. - Si tel est le cas, résolvez le conflit. Habituellement, vous devrez ajouter la nouvelle carte au-dessus des cartes qui ont été ajoutées depuis la création du fork. - Si tout le reste va bien, approuvez le PR, écrivez un message au contributeur pour le remercier pour sa contribution (en vous rappelant qu'il s'agit d'un premier venu et qu'il bénéficierait d'encouragements). - Fusionnez le PR dans `master`. @@ -56,7 +52,7 @@ Le projet a installé Prettier pour garantir que quelle que soit la manière don Si vous remarquez que le fichier HTML semble désordonné, exécutez le code ci-dessous à la racine du projet. ```js -npx plus joli --write index.html +npx prettier --write index.html ``` Il devrait essayer de formater le fichier et s'il n'y parvient pas, il vous montrera les erreurs. Parfois, une balise de fermeture manquante ou un code HTML cassé est fusionné par erreur et c'est un bon moyen de le repérer et de le corriger.