From bdceb9e65d164f7fb1683151497f3b2e93ae492b Mon Sep 17 00:00:00 2001 From: Antoine Wecxsteen Date: Wed, 30 Dec 2020 17:54:57 +0100 Subject: [PATCH 1/6] Modif. mineure. --- CONTRIBUTING.rst | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index eb38ec079..6d7f800a5 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -65,8 +65,7 @@ dans les tickets et les *pull requests*. Vous êtes maintenant prêt. Chaque fois que vous commencerez un nouveau fichier, suivez cette procédure : -Pour travailler, nous aurons 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 +Pour travailler, nous aurons besoin d'une branche, basée sur une version à jour de la branche « upstream/3.9 ». On met donc à jour notre version locale. .. code-block:: bash @@ -74,10 +73,9 @@ version locale. git fetch upstream -On crée ensuite une branche. Il est pratique de nommer la branche en fonction du +On crée ensuite la branche, en la basant sur « upstream/3.9 », fraîchement récupérée. Il est pratique de nommer cette branche en fonction du fichier sur lequel on travaille. Par exemple, si vous travaillez sur « library/sys.po », vous pouvez nommer votre branche « library-sys ». -Cette nouvelle branche nommée « library-sys » est basée sur « upstream/3.9 ». .. code-block:: bash From 7b0be306c062d44e98a3852d830938dfdfbe3ce5 Mon Sep 17 00:00:00 2001 From: Antoine Wecxsteen Date: Wed, 30 Dec 2020 18:04:46 +0100 Subject: [PATCH 2/6] Modif. mineure II. --- CONTRIBUTING.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 6d7f800a5..6ba2fdb7e 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -44,13 +44,17 @@ où vous avez le droit de faire des modifications. Réservation d'un fichier ~~~~~~~~~~~~~~~~~~~~~~~~ +.. note:: + + Chaque fois que vous commencez un nouveau fichier, suivez cette procédure. + Ensuite, vous devez trouver un fichier sur lequel travailler (pour vous aiguiller, lisez la section `Que traduire ?`_). Nous vous conseillons de choisir, si possible, un fichier traitant d'un sujet que vous maitrisez, cela vous aidera grandement à produire une traduction de bonne qualité. Si c'est votre première contribution, commencez par une toute petite -PR, de quelques paragraphes maximum, pour vous familiariser. Il n'est +traduction, de quelques paragraphes maximum, pour vous familiariser. Il n'est 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. @@ -62,9 +66,6 @@ en indiquant dans le titre ``Je travaille sur DOSSIER/FICHIER.po`` Ceci permet à `potodo`_ de détecter via l'API Github les fichiers ``.po`` réservés dans les tickets et les *pull requests*. -Vous êtes maintenant prêt. Chaque fois que vous commencerez un nouveau fichier, -suivez cette procédure : - Pour travailler, nous aurons besoin d'une branche, basée sur une version à jour de la branche « upstream/3.9 ». On met donc à jour notre version locale. @@ -682,10 +683,10 @@ Powrap | `Lien vers le dépôt `__ -Simplification des diffs git -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Simplification des git diff +~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Les diffs git sont souvent encombrés de changements inutiles de numéros +Le résultat de *git diff* est souvent encombré de changements inutiles de numéros de ligne, comme : .. code-block:: diff @@ -694,7 +695,7 @@ de ligne, comme : +#: ../Doc/library/signal.rst:408 -Pour dire à git que ce ne sont pas des informations utiles, vous pouvez faire +Pour dire à Git que ce ne sont pas des informations utiles, vous pouvez faire ce qui suit après vous être assuré que ``~/.local/bin/`` se trouve dans votre ``PATH``. From 07db9551cb4436e91264b101fb259015c3c39e48 Mon Sep 17 00:00:00 2001 From: Antoine Wecxsteen Date: Wed, 30 Dec 2020 18:09:07 +0100 Subject: [PATCH 3/6] Modif. mineure III. --- CONTRIBUTING.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 6ba2fdb7e..36224ade0 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -683,16 +683,16 @@ Powrap | `Lien vers le dépôt `__ -Simplification des git diff -~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Affichage des modifications par Git +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Le résultat de *git diff* est souvent encombré de changements inutiles de numéros +Le résultat de ``git diff`` est souvent encombré de changements inutiles de numéros de ligne, comme : .. code-block:: diff - -#: ../Doc/library/signal.rst:406 - +#: ../Doc/library/signal.rst:408 + -#: ../Doc/library/sys.rst:406 + +#: ../Doc/library/sys.rst:408 Pour dire à Git que ce ne sont pas des informations utiles, vous pouvez faire From 4e2da18b74663783dc2a04a18fcbbd76040291ac Mon Sep 17 00:00:00 2001 From: Antoine Wecxsteen Date: Wed, 30 Dec 2020 18:14:04 +0100 Subject: [PATCH 4/6] Fix issue on Note. --- CONTRIBUTING.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 36224ade0..a678a5d2d 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -45,8 +45,7 @@ Réservation d'un fichier ~~~~~~~~~~~~~~~~~~~~~~~~ .. note:: - - Chaque fois que vous commencez un nouveau fichier, suivez cette procédure. + Chaque fois que vous commencez un nouveau fichier, suivez cette procédure. Ensuite, vous devez trouver un fichier sur lequel travailler (pour vous aiguiller, lisez la section `Que traduire ?`_). Nous vous conseillons From e660b815cddefcf39c6295c72b24bb74f00a1fb7 Mon Sep 17 00:00:00 2001 From: Antoine Wecxsteen Date: Wed, 30 Dec 2020 18:17:21 +0100 Subject: [PATCH 5/6] 'Note' rendering in Github looks ugly. --- CONTRIBUTING.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index a678a5d2d..b7c0b6288 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -44,8 +44,7 @@ où vous avez le droit de faire des modifications. Réservation d'un fichier ~~~~~~~~~~~~~~~~~~~~~~~~ -.. note:: - Chaque fois que vous commencez un nouveau fichier, suivez cette procédure. +*Chaque fois que vous commencez un nouveau fichier, suivez cette procédure.* Ensuite, vous devez trouver un fichier sur lequel travailler (pour vous aiguiller, lisez la section `Que traduire ?`_). Nous vous conseillons From a56c5abec51ed060b135cad3be40a7b314719dae Mon Sep 17 00:00:00 2001 From: Antoine Wecxsteen Date: Wed, 30 Dec 2020 19:14:38 +0100 Subject: [PATCH 6/6] Indentation. --- CONTRIBUTING.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index b7c0b6288..1e9a95905 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -64,15 +64,16 @@ en indiquant dans le titre ``Je travaille sur DOSSIER/FICHIER.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 aurons besoin d'une branche, basée sur une version à jour de la branche « upstream/3.9 ». On met donc à jour notre -version locale. +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. .. code-block:: bash git fetch upstream -On crée ensuite la branche, en la basant sur « upstream/3.9 », fraîchement récupérée. Il est pratique de nommer cette branche en fonction du +On crée ensuite la branche, en la basant sur « upstream/3.9 », fraîchement récupérée. +Il est pratique de nommer cette branche en fonction du fichier sur lequel on travaille. Par exemple, si vous travaillez sur « library/sys.po », vous pouvez nommer votre branche « library-sys ».