Apprendre Git est une compétence essentielle dans le développement de logiciels. La popularité croissante des logiciels open source a conduit au succès de Git. Vous pouvez l'utiliser pour suivre les contributions, gérer la collaboration et héberger des bases de code dans des référentiels distants.
Git joue un rôle essentiel dans la plupart des projets open source. Découvrez quelle relation Git entretient avec l'open source et comment vous pouvez utiliser cet outil productif pour booster vos contributions.
La relation entre Git et l'open source
Git est un logiciel de contrôle de version largement utilisé dans le développement. Git vous permet de suivre les modifications logicielles en temps réel, d'enregistrer des copies de votre code dans des référentiels distants et de collaborer en ligne. Découvrez en détail Git dans notre tutoriel Git avancé.
Git est également un projet open source sur lequel les contributeurs ont travaillé pour s'améliorer au fil du temps. Les logiciels open source sont généralement gratuits pour tout le monde. Un logiciel devient open source lorsque le propriétaire accorde à quiconque le droit d'utiliser, de modifier et de distribuer le code source.
Les contributions open source se produisent de manière publique et collaborative, également appelée «Building in Public». En savoir plus sur la différence entre logiciels open-source et open-source.
Git possède des fonctionnalités collaboratives essentielles en open source. Git permet aux équipes de maintenir des projets en collaboration. Il vous permet de récupérer du code, d'ajouter des contributions sur votre ordinateur local et de soumettre vos modifications pour examen.
Fonctionnalités Git utilisées dans l'Open Source
Git a plusieurs commandes utilisées pour effectuer des opérations sur son interface. Il existe de nombreuses commandes de ce type, mais vous n'avez pas besoin de toutes les apprendre pour contribuer à l'open source. Voici quelques termes et commandes de base que vous rencontrerez :
- Fourchette: Une copie d'un référentiel GitHub (repo). Lorsque vous faites un fourchette, vous en obtenez une copie sur votre compte GitHub, ce qui vous permet de modifier le contenu sans affecter le référentiel parent du projet.
- Problème: Une idée, un bogue ou une tâche sur laquelle les contributeurs peuvent travailler. Un problème avec une étiquette comme bon premier numéro est une tâche simple destinée à motiver les contributeurs à participer à des projets open source.
- Étiqueter:Utilisé pour classer les problèmes et les discussions.
- Mainteneurs: Contributeurs autorisés à modifier les fichiers dans le référentiel d'un projet. Ils sont également appelés propriétaires de code.
- Contributeurs : Toute personne qui contribue au code, à la documentation ou à d'autres ressources techniques pour un projet.
Voici quelques commandes courantes que vous utiliserez dans le développement open source :
- Bifurquer: Une copie du contenu du dépôt. Un dépôt peut avoir plusieurs branches: la branche principale et plusieurs autres, si nécessaire. La branche par défaut est principal/maître, et vous pouvez nommer des branches supplémentaires en fonction de leur objectif.
- Fusionner:Fusionner signifie joindre différentes branches ensemble de manière à ce qu'elles aient le même code.
- Demande d'extraction (RP) : Avertit la maintenance que vous avez envoyé du code qui doit être révisé. Faites une demande d'extraction lorsque vous êtes prêt à fusionner avec la branche mère et que vous avez besoin d'avis d'autres personnes.
- Télécommande: Version en ligne de votre référentiel local.
- Aller chercher: Télécharge le contenu d'un référentiel distant dans votre référentiel local.
- Commettre: Suit les modifications apportées à un fichier sur un référentiel local ou en ligne. Tous les commits ont un identifiant unique qui enregistre des détails sur l'auteur, l'heure et la nature des modifications apportées.
Premiers pas avec l'open source
Dans ce didacticiel, nous examinerons les étapes de base que vous suivrez pour apporter votre première contribution à l'open source. Nous utiliserons Git comme référentiel local et GitHub comme référentiel distant. Voici comment commencer.
1. Choisissez un projet
Identifiez un projet approprié auquel contribuer. Vos compétences et votre passion pour faire la différence détermineront le projet que vous choisirez. Vous pouvez apporter une fonctionnalité, une documentation ou des compétences telles que la gestion de produits.
Le bon projet aura une communauté active sur les réseaux sociaux tels que Slack ou Twitter. Son référentiel doit avoir des contributions régulières et des licences appropriées pour les logiciels open source.
2. Obtenir le guide des contributeurs
Chaque projet open source réputé devrait avoir un guide des contributeurs. Le guide contient des instructions et des instructions pour montrer aux nouveaux développeurs comment contribuer au projet.
Vous apprendrez à bifurquer, à travailler sur un problème et à faire une demande d'extraction au dépôt en amont pour permettre aux mainteneurs d'examiner votre contribution. Vous trouverez très probablement le guide des contributeurs dans le dossier racine du projet.
Le guide des contributeurs vous aidera à comprendre le flux de travail du projet et à réduire les conflits de fusion. Si vous ne respectez pas ces lignes directrices pour les contributeurs, un responsable peut rejeter votre demande d'extraction.
Voici un exemple de guide des contributeurs de la AsyncAPI projet.
3. Choisissez un problème
Un problème peut être tout ce à quoi vous aimeriez contribuer. Il peut s'agir d'une demande que vous avez identifiée dans la section des problèmes du référentiel du projet, d'une faute de frappe ou d'une documentation que vous souhaitez ajouter au projet.
Avant de commencer à travailler sur un problème, renseignez-vous ou discutez d'abord de la problème avec les mainteneurs. Parfois, il peut s'agir d'un problème obsolète ou d'un problème sur lequel un autre contributeur travaille déjà. Voici à quoi ressemble la section des problèmes sur GitHub :
4. Travailler sur la question
Une fois que les responsables ont approuvé le problème, vous pouvez configurer un référentiel forké. Forking vous fournira une copie du référentiel parent dans votre référentiel. Vous allez cloner le référentiel sur votre machine locale avec le clone git commande.
Vous pouvez ouvrir le dossier sur votre éditeur de code préféré et commencer à travailler. Ici, il est essentiel de connaître la syntaxe de langages de balisage populaires comme Markdown, qui est populaire dans la plupart des projets open source. Si vous travaillez sur un problème de documentation, vous utiliserez probablement Markdown comme illustré ci-dessous :
5. Soumettez votre travail pour examen
Lorsque vous avez terminé de travailler sur le problème, suivez le flux de travail du guide des contributeurs pour envoyer votre travail à GitHub pour examen. Utilisez les étapes suivantes pour configurer le fork et le soumettre pour examen.
- Connectez votre dépôt local au dépôt en amont du projet à l'aide de cette commande :
git remote ajouter en amont https ://github.com/{original-owner}/{original-repository}.git
- Utiliser git récupérer pour télécharger le contenu de la branche amont dans votre branche locale :
git branch -u amont/maître maître
- Créer une nouvelle branche avec branche git . Vous pouvez vérifier si la nouvelle branche est créée avec branche git commande.
- Mettez en scène votre succursale avec git ajouter et engagez-le avec git commettre -m.
- Poussez votre code vers la branche GitHub avec git push origine .
- Faire un demande d'extraction(RP). Un PR avertit les mainteneurs d'examiner votre branche et de suggérer des modifications avant la fusion. Ce diagramme résume l'ensemble du processus.
6. Examens et fusion
Après avoir soumis le PR, les mainteneurs examineront probablement et suggéreront des modifications. Vous pouvez apporter des modifications locales ou commettre les modifications proposées sur le référentiel distant. GitHub a une disposition pour commettre change à distance.
Au cours de l'examen, vous recevrez des commentaires sur votre contribution et pourrez demander des éclaircissements sur certains points. Vous trouverez ci-dessous une illustration de la manière dont vous pouvez valider des modifications sur GitHub :
Lorsque vous avez terminé d'apporter des modifications, créez de nouveaux commits. Les commits informeront les mainteneurs de revoir votre travail. Si toutes les vérifications sont réussies, votre PR sera rapidement fusionné. Toutes nos félicitations! Vous venez d'apporter votre première contribution à un projet open-source.
Git améliore la collaboration open source
Git joue un rôle essentiel dans les contributions open-source. Git permet aux grands et petits projets de suivre les contributions, de gérer les équipes et d'héberger différentes versions des codes sources. En tant que projet open source lui-même, Git a amélioré la qualité et la quantité des contributions aux logiciels open source.
Votre première contribution open source sera probablement intimidante, mais c'est facile et amusant une fois que vous avez appris le flux de travail. L'utilisation de Git vous aidera à affiner vos compétences en codage, à apprendre la collaboration et à réseauter avec les meilleures personnes de l'industrie technologique. Allez-y et lancez-vous !