Getting Started with GitHub

Question

Getting Started with GitHub

Opened this issue 4 years ago · 1 comments

github-learning-lab commented 4 years ago

👋 Bienvenue au cours "Introduction à GitHub" de GitHub Learning Lab

Pour commencer, je vais vous guider à travers quelques premières étapes importantes de la programmation et la collaboration sur GitHub.

👇 Cette flèche signifie que vous pouvez agrandir la fenêtre. Cliquez dessus tout au long du cours pour trouver plus d'informations.

Qu'est-ce que GitHub?

Merci d'avoir posé cette question! Beaucoup de gens viennent sur GitHub parce qu'ils veulent contribuer à des projets libres (open source ^📖), ou ils sont invités par des collègues ou des camarades de classe qui l'utilisent pour leurs projets. Pourquoi les gens utilisent-ils GitHub pour ces projets?

GitHub est une plateforme de collaboration.

Des logiciels aux documents juridiques, vous pouvez compter sur GitHub pour vous aider à réaliser le meilleur travail possible avec les outils de collaboration et de sécurité dont votre équipe a besoin. Avec GitHub, vous pouvez garder des projets complètement privés ou inviter des personnes à collaborer et fluidifier chaque étape de votre projet.

GitHub est également un puissant outil de contrôle de version.

GitHub utilise Git ^📖, l'outil open source de gestion de version le plus populaire, afin de tracer chaque contribution et contributeur ^📖 de votre projet, afin que vous sachiez d'où vient chaque ligne de code.

GitHub vous aide à faire beaucoup plus.

GitHub est utilisé pour créer certaines des technologies les plus avancées au monde. Que vous visualisiez des données ou construisiez un nouveau jeu, il existe toute une communauté et un ensemble d'outils sur GitHub qui peuvent vous aider à passer à l'étape suivante. Ce cours commence par les bases, mais nous approfondirons le reste plus tard!

📺 Qu'est-ce que GitHub?

Exploration d'un dépôt GitHub

📺 Video: Exploration d'un dépôt

Autres fonctionnalités

La vidéo a couvert certaines des fonctionnalités les plus utilisées. Voici quelques autres éléments que vous pouvez trouver dans les dépôts GitHub :

Tableaux de suvi de projet : créez un tableau de suivi des tâches de style Kanban dans GitHub
Wiki : créer et stocker la documentation relative à votre projet
Insights : affichez des outils d'analyse pour votre dépôt, notamment :
- Pulse: tableau de bord de projet pemettant la recherche d'information sur les travaux terminés et les travaux en cours
- Graphiques : les graphiques fournissent une vue plus granulaire de l'activité du dépôt, donnant des détails sur qui a contribué au dépôt, qui l'a créé et quand les contributions ont été effectuées

Fichiers spéciaux

Dans la vidéo, vous avez découvert un fichier spécial appelé README.md. Voici quelques autres fichiers spéciaux que vous pouvez ajouter à vos dépôts :

CONTRIBUTING.md: Le fichier CONTRIBUTING.md est utilisé pour décrire le processus de contribution aux dépôts. Un lien vers le fichier CONTRIBUTING.md est affiché chaque fois que quelqu'un crée une nouvelle Issue ou une Pull Request.
ISSUE_TEMPLATE.md: ISSUE_TEMPLATE.md est un autre fichier que vous pouvez utiliser pour préremplir le corps d'une Issue. Par exemple, si vous avez toujours besoin des mêmes types d'informations pour les rapports de bugs, incluez-les dans le modèle d'Issue, et chaque nouvelle Issue sera ouverte avec votre texte de démarrage recommandé.

Utiliser les Issues

Ceci est une Issue ^📖: un endroit où vous pouvez avoir des conversations sur les bugs dans votre code, la révision du code et à peu près tout le reste.

Les titres des Issues sont comme les lignes d'objet des e-mails. Ils indiquent à vos collaborateurs de quoi il s'agit en un coup d'œil. Par exemple, le titre de cette Issue est "Getting started with GitHub".

Utiliser les Issues GitHub

Les Issues sont utilisées pour discuter des idées, des améliorations, des tâches et des bugs. Elles facilitent la collaboration en :

Fournissant à tout le monde (même aux futurs membres de l'équipe) l'historique complet en un seul endroit
En permettant les références croisées avec d'autres Issues et Pull Requests ^📖
Centralisant dans un dépôt unique les décisions et leurs motivations
Vous permettant d'inclure facilement les bonnes personnes et les bonnes équipes dans une conversation avec les @-mentions

📺 Video: Utiliser les Issues GitHub

Gérer les notifications

📺 Video: Watching, notifications, stars, et explore

Une fois que vous avez commenté une Issue ou une Pull Request, vous commencerez à recevoir des notifications par e-mail dès lors qu'il y aura de l'activité dans le fil d'actualité.

Comment faire taire ou réactiver des Issues spécifiques

Aller à l'Issue ou la Pull Request
Sous "Notifications", cliquez le bouton Unsubscribe à droite afin de taire les notifications ou le bouton Subscribe afin de les activer

Vous verrez une courte description qui explique votre statut de notification actuel.

Comment personnaliser les notifications dans vos réglages

Cliquez votre photo de profil
Cliquez Settings
Cliquez Notifications depuis le menu de gauche et ajustez vos préférences de notification

Options de notification du dépôt

Watch: Vous recevrez une notification lorsqu'une nouvelle Issue, une Pull Request ou un commentaire est publié, et lorsqu'une Issue est fermé ou qu'une Pull Request est fusionnée
Not watching: Vous ne recevrez plus de notifications sauf si vous êtes @-mentionné
Ignore: Vous ne recevrez plus de notifications du dépôt

Comment configurer les notifications des dépots que vous suivez

Cliquez votre photo de profil
Cliquez Settings
Cliquez Notifications depuis le menu de gauche
Cliquez sur le lien "things you’re watching"
Sélectionnez l'onglet Watching t
Cliquez le bouton Unwatch pour désactiver les notifications, ou Watch les activer

Continuez à lire ci-dessous pour trouver votre première tâche

Answer 1 · 2021-02-15T13:34:24.000Z

Étape 1: Assignation

Les Issues non assignées ne sont sous la responsabilité de personne. Lorsque vous êtes assigné à une Issue ou une Pull Request, les visiteurs du dépôt sont informés que vous êtes le facilitateur de la discussion ou de la tâche 💪.

⌨️ Activité

Sur la partie droite de l'écran, sous la section "Assignees", cliquez l'icône engrenage et séléctionnez vous.

Pour obtenir une version imprimable des étapes de ce cours, visitez le Quick Reference Guide.

Je vous réponderai dès que vous vous serez assigné cette Issue.

Parfois je réponds trop rapidement et la page n'a pas le temps de s'actualiser. Si vous avez effectué l'action espérée et que vous ne voyez pas de réponse de ma part, attendez quelques secondes et rafraîchissez la page afin d'obtenir les prochaines instructions.