diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index eb38ec07..1e9a9590 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -44,13 +44,15 @@ où vous avez le droit de faire des modifications. Réservation d'un fichier ~~~~~~~~~~~~~~~~~~~~~~~~ +*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,22 +64,18 @@ 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 -(fraîchement récupérée) 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 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 @@ -684,19 +682,19 @@ Powrap | `Lien vers le dépôt `__ -Simplification des diffs git -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Affichage des modifications par Git +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -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 - -#: ../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 +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``.