Github pour les nuls

En deux mots : Github propose un éditeur en ligne qui vous permet de contribuer à un projet, sans devoir importer puis gérer de dépôt local ni employer la moindre ligne de commande. Cette manœuvre peut convenir si votre contribution est occasionnelle ou mineure (corriger une coquille, un lien mort, un fragment de code...)

Table of Contents Prérequis Allez sur la page du projet github Déplacez-vous vers le fichier à modifier Cliquez sur le bouton Edit this file Comme prévu une fenêtre d'édition vous est accessible... Validez votre proposition avec ce bouton Cliquez sur le joli bouton vert Send Pull Request

Prérequis

Vous devez disposer d'un compte github

Allez sur la page du projet github

par exemple https://github.com/mozfr/www et identifiez-vous

Déplacez-vous vers le fichier à modifier

...par exemple celui-ci où vous avez repéré une coquille

300px

Cliquez sur le bouton Edit this file

Un message en infobulle vous informe que le projet est automatiquement "forké" pour que vous puissiez éditer. Ne vous inquiétez pas, tout est normal, c'est comme une copie personnelle du projet qui vous est créée.

Fichier:Github_editfile.png

Comme prévu une fenêtre d'édition vous est accessible...

...en blanc sur fond noir. Opérez les modifications nécessaires

Fichier:Github_editwindow.png‎

Notez qu'il existe un petit menu déroulant pour modifier le nombre d'espaces destinées à l'indentation du code, et un autre qui propose le "retour à la ligne" (soft wrap) pour les longues lignes.

Validez votre proposition avec ce bouton

Fichier:Github_propose-button.png‎

Une nouvelle fenêtre s'ouvre qui vous propose de faire un pull request, c'est-à-dire une demande pour que votre modification soit envoyée sur le projet principal.

Cliquez sur le joli bouton vert Send Pull Request

... après avoir indiqué en quelques mots la nature de votre modification dans le champ prévu à cet effet

Fichier:Poule-ricoueste.png

... et voilà ! votre demande est envoyée, c'est maintenant l'affaire des administrateurs du projet. Dès que votre correctif ("patch") sera intégré au projet, vous en serez informé.

Fichier:Github_fin.png

• Pour s'y retrouver dans le vocabulaire franglais de ce genre de choses cette page bien faite
• Pour une prise en mains plus élaborée du Github, ce petit guide

Catégorie:Devops