Découvrez ci-dessous comment vous pouvez rejoindre un projet existant ou développer le vôtre.
Nous ne sommes pas inquiets si vous cassez ce dépôt. C'est un terrain de jeu et nous vous encourageons à échouer souvent. Utilisez ce dépôt comme un terrain d'entraînement et prenez plaisir à contribuer aux projets que vous réalisez avec les autres étudiants. De nombreux étudiants ont acquis une expérience réelle du "travail en équipe" en travaillant sur ces projets.
-
Consultez l'article Qu'est-ce que Git & GitHub ?.
-
Sur la page GitHub de ce dépôt, cliquez sur le bouton "Fork".
-
Clonez votre dépôt forké sur votre ordinateur :
Par exemple, exécutez cette commande dans votre terminal :
git clone https://github.com/<votre-pseudo-github>/demarrer-avec-git.git
Remplacez <votre-pseudo-github>
Pour en savoir plus sur le forking et le clonage d'un repo.
-
Accédez au répertoire du projet :
cd demarrer-avec-git -
Avant d'apporter des modifications, maintenez votre fork en phase pour éviter les conflits de fusion :
git remote add upstream https://github.com/digifab-dev/demarrer-avec-git.git git pull upstream main
Si vous rencontrez un merge conflict, vous devez résoudre le conflit. Il existe de nombreux guides en ligne, vous pouvez aussi essayer celui de opensource.com.
-
Après avoir ajouté le upstream et vérifié que tous les fichiers sont à jour, nous allons maintenant faire une nouvelle branche avant de modifier tout fichier. Il y a deux façons de faire :
git checkout -b <nom-de-branche>
git branch <nom-de-branche> git switch <nom-de-branche>
-
Sur votre ordinateur, ouvrez votre éditeur de texte, et ajoutez votre nom au fichier
CONTRIBUTORS.md. -
Ajoutez les changements avec
git add,git commit(écrire un bon message de commit, si possible) :git add CONTRIBUTORS.md git commit -m "Ajout de <votre-pseudo-github>"Remplacez <votre-pseudo-github>
-
Poussez vos changements vers votre dépôt :
git push origin <nom-de-branche>
-
Allez sur la page GitHub de votre fork, et faites une pull request :
Pour en savoir plus sur les pull requests, consultez la page d'aide de GitHub.
-
Attendez que l'un des mainteneurs fusionne votre demande de modification. S'il y a des conflits, vous recevrez une notification.
-
Rejoignez un projet et commencez à contribuer ou à former vos propres groupes d'applications. Soyez audacieux et prenez plaisir à développer des projets ensemble ! Consultez ce guide pour plus d'informations sur la sélection d'un projet.
-
Pour voir l'icône Digifab dans votre profil GitHub, inscrivez-vous ici puis suivez ces étapes (vous devez effectuer les étapes 1 et 2 pour que cela fonctionne).
Chaque communauté open source est différente.
Passer des années sur un projet open source signifie que vous avez appris à connaître un projet open source. Passez à un autre projet et vous découvrirez que le vocabulaire, les normes et les styles de communication sont complètement différents.
Cela dit, de nombreux projets open source suivent une structure organisationnelle similaire. Comprendre les différents rôles de la communauté et le processus global vous aidera à vous orienter rapidement vers un nouveau projet.
Un projet open source typique comprend les types de personnes suivants :
Author : La personne ou l'organisation qui a conçu le projet.
Owner : La ou les personnes qui ont la propriété administrative de l'organisation ou du dépôt (ce n'est pas toujours la même chose que l'auteur original).
Maintainers : Les contributeurs qui sont responsables de la vision et de la gestion des aspects organisationnels du projet (peuvent également être les auteurs ou les propriétaires du projet).
Contributors : Toute personne qui a contribué au projet.
Membres de la communauté : Les personnes qui utilisent le projet. Ils peuvent être actifs dans les conversations ou exprimer leur opinion sur la direction du projet.
Les grands projets peuvent également avoir des sous-comités ou des groupes de travail axés sur différentes tâches, telles que l'outillage, le triage, la modération de la communauté et l'organisation d'événements. Pour trouver ces informations, consultez la page "équipe" du site Web d'un projet ou le dépôt de la documentation sur la gouvernance.
Un projet possède également une documentation. Ces fichiers sont généralement répertoriés à la racine du dépôt.
LICENSE : Par définition, chaque projet open source doit avoir une licence open source. Si le projet n'a pas de licence, il n'est pas open source.
README : Le README est le manuel d'instruction qui accueille les nouveaux membres de la communauté dans le projet. Il explique pourquoi le projet est utile et comment le démarrer.
CONTRIBUTING : Alors que les README aident les usagers à utiliser le projet, les docs de contribution aident les usagers à contribuer au projet. Elle explique quels types de contributions sont nécessaires et comment le processus fonctionne. Bien que tous les projets ne disposent pas d'un fichier CONTRIBUTING, sa présence indique qu'il s'agit d'un projet accueillant pour les contributions.
CODE_OF_CONDUCT : Le code de conduite fixe les règles de base du comportement des participants associés et contribue à faciliter un environnement convivial et accueillant. Bien que tous les projets ne disposent pas d'un fichier CODE_OF_CONDUCT, sa présence indique qu'il s'agit d'un projet accueillant auquel contribuer.
Autre documentation : Il peut y avoir une documentation supplémentaire, comme des tutoriels, des instructions ou des politiques de gouvernance, en particulier pour les projets plus importants.
Enfin, les projets open source utilisent les outils suivants pour organiser la discussion. La lecture des archives vous donnera une bonne idée de la façon dont la communauté pense et travaille.
Issue tracker : Où les participants discutent des problèmes liés au projet.
Pull requests : Où les participants discutent et examinent les changements en cours.
Forums de discussion ou listes de diffusion : Certains projets peuvent utiliser ces canaux pour des sujets de conversation (par exemple, "Comment puis-je..." ou "Que pensez-vous de..." au lieu de rapports de bogues ou de demandes de fonctionnalités). D'autres utilisent le gestionnaire des incidents pour toutes les conversations.
Canal de discussion synchrone : Certains projets utilisent des canaux de discussion (tels que Discord ou IRC) pour les conversations informelles, la collaboration et les échanges rapides.