Modifications mineures du guide de contribution. (#1509)

This commit is contained in:
Antoine 2020-12-31 10:37:50 +01:00 committed by GitHub
parent b17122d389
commit 835e083e65
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 15 deletions

View File

@ -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 <https://github.com/JulienPalard/powrap>`__
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``.