GitHub est une plate-forme en ligne appartenant à Microsoft et utilisée pour héberger du code. Il est utilisé pour le contrôle de version et la collaboration et permet aux développeurs de travailler sur un projet en même temps de n'importe où.
Sur GitHub, les développeurs peuvent facilement créer des référentiels qui sont généralement utilisés pour organiser des projets. Ces référentiels peuvent contenir des dossiers, des fichiers, des images, des vidéos, des feuilles de calcul, des ensembles de données ou tout ce dont votre projet a besoin. Ils sont également livrés avec un fichier Lisezmoi.md, qui est un endroit pour décrire votre projet et fournir des informations à son sujet.
Comment créer un référentiel
Suivez ces étapes lors de la création d'un référentiel.
- Cliquer sur +, situé dans le coin supérieur droit de la page. Sélectionnez ensuite Nouveau référentiel.
- Choisissez un nom pour votre référentiel (j'utiliserai « Salut tout le monde »).
- Rédigez une brève description du référentiel.
- Sélectionner Initialisez ce référentiel avec un fichier README.
- Clique sur le Créer un référentiel bouton.
Comment créer une succursale
Lorsque différents développeurs souhaitent travailler sur le même document en même temps, ils utilisent une fonctionnalité de GitHub appelée Branching. Par défaut, lorsque vous créez un référentiel, il n'a qu'une seule branche appelée branche principale. Les branches sont utilisées pour expérimenter ou éditer le code avant de les affecter définitivement à la branche maître.
Lorsqu'une succursale est créée à partir d'une succursale principale, le nouveau bureau est une copie de la succursale principale au moment où le département a été créé. De plus, si après avoir créé votre branche, quelqu'un apporte des modifications à la branche principale, vous pouvez importer ces modifications dans votre nouvelle branche.
Étapes pour créer une nouvelle branche
- Accédez à votre nouveau référentiel, "Salut, tout le monde".
- Cliquez sur le menu déroulant en haut de la liste des fichiers qui dit branche: maître.
- Tapez un nom pour votre nouvelle branche, disons « illusBranch », dans la zone de texte de la nouvelle branche.
- Clique sur le Créer une branche boîte ou appuyez sur "Entrer" sur le clavier.
Apporter et valider des changements
Vous êtes maintenant dans la vue du code de votre « illusBranch », qui est une copie de la branche principale. Sur la plate-forme GitHub, toutes les modifications que vous apportez et enregistrez sont appelées « commits ». Ils ont une entrée jointe qui détaille quelles étaient ces modifications.
Apporter et valider des modifications
- Tout d'abord, cliquez sur le Lisez-moi.md déposer.
- Ensuite, cliquez sur l'icône en forme de crayon dans le coin droit de la vue du fichier. Cela vous permettra de modifier le code.
- Lorsque l'éditeur s'ouvre, saisissez les modifications que vous souhaitez apporter.
- Écrivez un message de validation qui décrit le mieux les modifications que vous avez apportées au fichier readme.md.
- Clique sur le Valider les modifications bouton.
Comment ouvrir une demande de tirage
Vous avez maintenant apporté des modifications à une branche du maître et pouvez extraire une requête. Lorsque vous ouvrez une demande d'extraction, vous présentez les modifications que vous proposez et demandez une révision à d'autres. Si les réviseurs acceptent vos modifications, ils fusionneront les modifications proposées dans leurs branches. Les demandes d'extraction montrent des différences dans le contenu des deux branches. Tous les changements apparaîtront en rouge ou en vert. Vous pouvez accéder à un commit avec une pull request immédiatement après l'avoir créé pour ouvrir une discussion autour de celui-ci.
Comment marquer les fichiers comme affichés
Pour les développeurs qui travaillent sur des bases de code volumineuses, il est rare d'éviter les demandes d'extraction volumineuses. La recherche et l'examen des fichiers peuvent prendre plusieurs heures. Le temps passé à chercher peut facilement faire oublier à quelqu'un où il se trouvait. Un moyen simple de garder une trace des données que vous avez examinées consiste à marquer les fichiers comme affichés.
Étapes pour marquer un fichier comme affiché
Vous pouvez voir votre progression en haut de la pull request. C'est là que vous verrez les fichiers que vous avez consultés et ceux que vous n'avez pas encore vus. Lorsque vous marquez un fichier comme affiché, il se réduit automatiquement, ce qui facilite sa révision.
Les images ci-dessous aident à illustrer les étapes.
- Créer un Demande de tirage.
- Ouvrez la demande d'extraction pour voir tous les fichiers nouvellement ajoutés ou modifiés.
- Cliquez sur un fichier pour le marquer comme affiché. Cela réduit le fichier.
Le marquage d'un fichier est une fonctionnalité pratique de GitHub pour aider les réviseurs à se concentrer sur leur travail et à suivre facilement leurs progrès. La fonction Visualisé vous permet également de savoir quand quelque chose change dans le code que vous avez déjà visualisé.
Par exemple, si vous ouvrez un fichier et que quelqu'un révise et modifie également quelque chose dans le code après que vous l'ayez déjà fait, le L'état d'affichage passera à « Modifié depuis la dernière vue ». Cela vous permet également de vérifier ce que les autres ont modifié au cours de leur Commentaires.
Emballer
Le codage d'un nouveau projet par vous-même peut sembler intimidant, alors ne faites pas cavalier seul! Microsoft a rendu la collaboration facile et efficace avec GitHub.