From 662b4ec48b27daa4fbef05cddc43da0d894b29e7 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Wed, 27 Jan 2021 21:11:22 +0100 Subject: [PATCH] Contributing out of Github (#1514) Automerge of PR #1514 by @JulienPalard by HS-157 --- CONTRIBUTING.rst | 88 ++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 74 insertions(+), 14 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 1e9a9590..661ae80c 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -7,16 +7,15 @@ Instructions Prérequis ~~~~~~~~~ -- un compte `Github `_ ; -- un client ``git`` `Linux `_ ou `Windows `_ ; +- un client ``git`` `Linux `_, `MacOS `_ ou `Windows `_ ; - un éditeur de fichier ``.po`` (comme `Poedit `_). Équipez-vous aussi de quelques outils pour vous aider dans votre traduction (voir `Outils utiles pour la traduction`_). -*fork* personnel -~~~~~~~~~~~~~~~~ +*fork* personnel sur Github +~~~~~~~~~~~~~~~~~~~~~~~~~~~ Pour commencer vous aurez besoin de *forker* le dépôt des sources `python-docs-fr `_ en cliquant sur son bouton @@ -41,6 +40,32 @@ où vous avez le droit de faire des modifications. git remote add upstream https://github.com/python/python-docs-fr.git +*fork* personnel sur une autre forge +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Si vous n'avez pas de compte Github, il est possible *fork* ce dépôt sur une autre forge. +Vous devez dans un premier temps initier un dépôt vide sur la forge où vous voulez héberger le +dépôt. + +.. code-block:: bash + + # Clonez en HTTPS le dépôt + git clone https://github.com/python/python-docs-fr + + # Allez dans le répertoire cloné + cd python-docs-fr/ + + # Renommez *origin* en *upstream* pour avoir une référence vers le dépôt officiel + # Il permettra de récupérer les nouveaux commits + git remote rename origin upstream + + # Rajoutez le *remote* de votre forge (en HTTPS ou SSH) + git remote add origin + + # Envoyez le dépôt sur votre forge et définir par défaut + git push -u origin + + Réservation d'un fichier ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -57,15 +82,28 @@ pas nécessaire de terminer un fichier lorsqu'on le commence, vous pouvez donc prendre n'importe quel fichier, mais ne traduire que quelques paragraphes. -Une fois que vous avez choisi un fichier sur lequel travailler, veuillez -ouvrir un `ticket sur Github `_ -en indiquant dans le titre ``Je travaille sur DOSSIER/FICHIER.po`` -(par exemple « Je travaille sur library/sys.po »). +Une fois que vous avez choisi un fichier sur lequel travailler vous pouvez nous +le signaler par différents moyens : + +* Soit en ouvrant un `ticket sur Github `_ + en indiquant dans le titre ``Je travaille sur DOSSIER/FICHIER.po`` + (par exemple « Je travaille sur library/sys.po »). + Ceci permet à `potodo`_ de détecter via l'API Github les fichiers ``.po`` réservés dans les tickets et les *pull requests*. -Pour travailler, nous avons besoin d'une branche, basée sur une version à jour de la branche « upstream/3.9 ». On met donc à jour -notre version locale. +* Soit en créant un sujet sur le + `discuss de l'AFPy `_ dans la section Traduction + en indiquant sur quoi vous travaillez et l'URL de votre dépôt. + +* Soit sur IRC en venant sur le canal `#python-docs-fr `_ pour nous le signaler. + +Vous êtes maintenant prêt. Chaque fois que vous commencerez un nouveau fichier, +suivez cette procédure : + +Pour travailler, nous avons besoin d'une branche, basée sur une version à jour +(fraîchement récupérée) de la branche « upstream/3.9 ». On met donc à jour notre +version locale. .. code-block:: bash @@ -174,16 +212,17 @@ attendant d'être propagées dans le dépôt local. -Poussez ensuite vos modifications sur votre *fork* Github avec ``git push``. +Poussez ensuite vos modifications sur votre *fork* avec ``git push``. Le ``-u`` n'est utile qu'une fois pour que votre client git se souvienne que cette -branche est liée à votre *fork* Github (et donc que vos futurs ``git pull`` et +branche est liée à votre *fork* (et donc que vos futurs ``git pull`` et ``git push`` sachent quoi tirer). .. code-block:: bash git push --set-upstream origin - +Sur Github +++++++++++ La commande précédente vous affiche un lien pour ouvrir une *pull request* sur Github. Si vous l'avez manqué, allez simplement sur https://github.com/python/python-docs-fr/pulls @@ -194,6 +233,26 @@ Mettez dans le commentaire de la *pull request* le texte suivant : « Closes #XXXX » où XXXX est le numéro du ticket GitHub créé pour réserver le fichier traduit. Cela permet à Github de lier la *pull request* au ticket de réservation. + +Sur une autre forge ++++++++++++++++++++ + +Quand vous avez poussé vos modifications, il y a plusieurs possibilités. + +Soit vous signalez via le `discuss de l'AFPy `_ ou sur IRC que +vous avez traduit une section. Nous viendrons récupérer les modifications pour les intégrer +sur Github. + +Soit en créant un *`bundle `_* Git, +pour cela, il faut créer un fichier contenant les différentes modifications effectuées. + +.. code-block:: bash + + git bundle create .bundle .. + +Puis nous partager ce *bundle* sur le `discuss de l'AFPy `_ pour pouvoir l'intégrer. + + À partir de là, quelqu'un passera en revue vos modifications, et vous fera des suggestions et corrections. Pour les prendre en compte, retournez sur votre branche contenant le fichier concerné (au cas où vous auriez commencé quelque chose d'autre @@ -232,6 +291,7 @@ Si nécessaire, les traductions seraient rétroportées sur les versions les plus anciennes par l'`équipe de documentation `_. + Que traduire ? -------------- @@ -464,7 +524,7 @@ tuple *n*-uplet (avec *n* en italique), on peut traduire *2-tuple* par « paire » ou « couple », *3-tuple* par « triplet », *4-tuple* par « quadruplet » etc. -underscore tiret bas, *underscore* +underscore tiret bas, *underscore*, sous-tiret whitespace caractère d'espacement ========================== ===============================================