diff options
Diffstat (limited to 'markup/pod/live-manual/media/text/fr/project_contributing.ssi')
-rw-r--r-- | markup/pod/live-manual/media/text/fr/project_contributing.ssi | 119 |
1 files changed, 119 insertions, 0 deletions
diff --git a/markup/pod/live-manual/media/text/fr/project_contributing.ssi b/markup/pod/live-manual/media/text/fr/project_contributing.ssi new file mode 100644 index 0000000..60a90cd --- /dev/null +++ b/markup/pod/live-manual/media/text/fr/project_contributing.ssi @@ -0,0 +1,119 @@ +:B~ Contribuer au projet + +1~contributing-to-project Contribuer au projet + +Lorsque vous soumettez une contribution, veuillez indiquer clairement le +copyright et inclure toute mention légale relative à la licence. Notez que +pour être acceptée, la contribution doit être déposée sous la même licence +que le reste du document, c'est-à-dire la GPL version 3 ou ultérieure. + +Les contributions au projet, comme les traductions et les correctifs, sont +bienvenues. Les livraisons au dépôt sont possibles pour tout le monde, +cependant, nous vous demandons d'envoyer les changements importants sur la +liste de diffusion au préalable. Veuillez consulter {Contacter}#contact pour +plus d'informations. + +Le ${project} utilise Git en tant que système de contrôle de version et de +gestion du code source. Comme expliqué dans {Dépôts Git}#git-repositories il +existe deux branches de développement principales: *{debian}* et +*{debian-next}*. Tout le monde peut faire des livraisons aux branches +debian-next des dépôts live-boot, live-build, live-config, live-images, +live-manual et live-tools. + +Cependant, il y a certaines restrictions. Le serveur rejette: + +_* Push non fast-forward. + +_* Commits merge. + +_* Ajout ou suppression d'étiquettes ou des branches. + +Même si toutes les livraisons pourraient être révisées, nous vous demandons +d'utiliser votre bon sens et de faire bonnes livraisons avec de bons +messages de livraison. + +_* Veuillez écrire les commentaires de livraison à l'aide de phrases +complètes, en commençant par une majuscule et en terminant par un point, et +avec la forme 'Fixing/Adding/Removing/Correcting/Translating/...'. + +_* Écrivez de bons messages de livraison. La première ligne doit être un +résumé précis du contenu du commit qui sera inclus dans le changelog. Si +vous avez besoin de faire quelques explications supplémentaires, écrivez-les +au-dessous en laissant une ligne vide après la première, puis une autre +ligne vide après chaque paragraphe. Les lignes des paragraphes ne doivent +pas dépasser 80 caractères. + +_* Faites des livraisons de façon atomique, c'est-à-dire, ne mélangez pas +des choses sans liens entre elles dans la même livraison. Faites un commit +différent pour chaque modification que vous apportez. + +2~ Faire des changements + +Afin de faire un push sur les dépôts, vous devez suivre la procédure +suivante. Ici, nous utilisons live-manual comme un exemple pour le remplacer +par le nom du dépôt dans lequel vous souhaitez travailler. Pour plus +d'informations sur la façon de modifier live-manual, consultez {Contribuer à +ce document}#how-to-contribute. + +_* Téléchargez la clé publique: + +code{ + + $ mkdir -p ~/.ssh/keys + $ wget http://live-systems.org/other/keys/git@live-systems.org -O ~/.ssh/keys/git@live-systems.org + $ wget http://live-systems.org/other/keys/git@live-systems.org.pub -O ~/.ssh/keys/git@live-systems.org.pub + $ chmod 0600 ~/.ssh/keys/git@live-systems.org* + +}code + +_* Ajoutez la section suivante à votre configuration openssh-client: + +code{ + + $ cat >> ~/.ssh/config << EOF + Host live-systems.org + Hostname live-systems.org + User git + IdentitiesOnly yes + IdentityFile ~/.ssh/keys/git@live-systems.org + EOF + +}code + +_* Clonez live-manual avec ssh: + +code{ + + $ git clone git@live-systems.org:/live-manual.git + $ cd live-manual && git checkout debian-next + +}code + +_* Assurez-vous d'avoir renseignés les champs d'auteur et d'email dans Git: + +code{ + + $ git config user.name "John Doe" + $ git config user.email john@example.org + +}code + +*{Important:}* Rappelez-vous que vous devez livrer les changements sur la branche *{debian-next}*. + +_* Effectuez vos modifications. Dans cet exemple, vous devriez commencer par +écrire une nouvelle section traitant l'application des correctifs et ensuite +préparer l'ajout des fichiers et écrire le message de livraison comme ceci: + +code{ + + $ git commit -a -m "Adding a section on applying patches." + +}code + +_* Envoyez votre commit au serveur: + +code{ + + $ git push + +}code |