# Hello World

Suivez cet exercice Hello World pour vous familiariser avec le flux de travail des pull requests de GitHub.

## Introduction

Ce tutoriel vous apprend GitHub les éléments essentiels tels que les dépôts, les branches, les commits et les demandes de fusion. Vous allez créer votre propre dépôt Hello World et découvrir le flux de travail des pull requests de GitHub, une méthode populaire pour créer et réviser du code.

Dans ce guide de démarrage rapide, vous allez :

* Créer et utiliser un référentiel.
* Démarrer et gérer une nouvelle branche.
* Apportez des modifications à un fichier et poussez-les vers GitHub sous forme de commits.
* Ouvrir et fusionner une pull request.

### Prerequisites

* Vous devez disposer d’un GitHub compte.

* Vous n’avez pas besoin de savoir coder, utiliser la ligne de commande ou installer Git (le logiciel de contrôle de version sur lequel GitHub est construit).

## Étape 1 : création d'un référentiel

La première chose que nous allons faire est de créer un référentiel. Vous pouvez imaginer qu’un référentiel est une sorte dossier qui contient des éléments connexes, tels que des fichiers, des images, des vidéos ou même d’autres dossiers. Un référentiel regroupe généralement des éléments qui appartiennent au même « projet » ou à la chose sur laquelle vous travaillez.

Souvent, les dépôts incluent un fichier LISEZ-MOI, à savoir un fichier qui contient des informations sur votre projet. Les fichiers LISEZMOI sont écrits en Markdown, qui est un langage facile à lire et à écrire pour mettre en forme du texte en clair. Vous pouvez en savoir plus sur les fichiers Markdown et README dans [Syntaxe d’écriture et de mise en forme de base](/fr/enterprise-server@3.21/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) et [Gestion du README de votre profil](/fr/enterprise-server@3.21/account-and-profile/how-tos/profile-customization/managing-your-profile-readme).

GitHub vous permet d’ajouter un fichier README en même temps que vous créez votre nouveau référentiel.
GitHub propose également d’autres options courantes telles qu’un fichier de licence, mais vous n’avez pas besoin de les sélectionner maintenant.

Votre dépôt `hello-world` peut constituer un endroit où vous stockez des idées, des ressources, voire même où vous partagez et discutez avec d'autres personnes.

1. Dans le coin supérieur droit de n’importe quelle page, sélectionnez sur <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-plus" aria-label="Create something new" role="img"><path d="M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z"></path></svg>, puis cliquez sur **Nouveau référentiel**.

   ![Capture d’écran d’un menu déroulant GitHub montrant les options permettant de créer des éléments. L’élément de menu « Nouveau référentiel » est souligné en orange foncé.](/assets/images/help/repository/repo-create-global-nav-update.png)

2. Dans la zone « Nom du dépôt », tapez `hello-world`.

3. Dans la zone « Description », tapez une brève description. Par exemple, tapez « Ce référentiel est destiné à pratiquer le GitHub flux ».

4. Indiquez si votre dépôt sera **public** ou **privé**.

5. Sélectionnez **Ajouter un fichier LISEZMOI**.

6. Cliquez sur **Créer le dépôt**.

## Étape 2 : Créer une branche

La création de branches vous permet d'avoir différentes versions d'un dépôt en même temps.

Par défaut, votre dépôt a une seule branche nommée `main` considérée comme la branche définitive. Vous pouvez créer des branches supplémentaires séparées de `main` dans votre dépôt.

L’utilisation de branche est utile quand vous voulez ajouter de nouvelles fonctionnalités à un projet sans modifier la source principale du code. Le travail effectué sur les différentes branches n'apparaît pas sur la branche principale tant que vous ne l'avez pas fusionné, ce que nous allons aborder plus tard dans ce guide. Vous pouvez utiliser des branches pour expérimenter et apporter des modifications avant de les commiter dans `main`.

Quand vous créez une branche en dehors de la branche `main`, vous effectuez une copie, ou un instantané, de cette branche `main` telle qu'elle est à ce moment-là. Si quelqu'un d'autre a apporté des modifications à la branche `main` pendant que vous travailliez sur votre branche, vous pouvez intégrer ces mises à jour.

Ce schéma montre :

* La branche `main`
* Une nouvelle branche appelée `feature`
* Le parcours qui `feature`passe par les étapes « Commit changes », « Submit pull request » et « Discuss proposed changes » avant d'être fusionné en `main`

![Diagramme des deux branches. La branche « feature » diverge de la branche « main » et est ensuite fusionnée dans la branche principale.](/assets/images/help/repository/branching.png)

### Création d’une branche

1. Cliquez sur l'onglet **Code** de votre dépôt `hello-world`.

2. Au-dessus de la liste des fichiers, cliquez sur le menu déroulant montrant **main**.

   ![Capture d’écran de la page du dépôt. Un menu déroulant, étiqueté avec une icône de branche et le texte « main (principal) », est mis en évidence avec un encadré orange.](/assets/images/help/branches/branch-selection-dropdown-global-nav-update.png)

3. Tapez un nom de branche, `readme-edits`, dans la zone de texte.

4. Cliquez sur **Créer une branche : readme-edits à partir de main**.

   ![Capture d'écran de la liste déroulante des branches d'un dépôt. « Créer une branche : readme-edits à partir de 'main' » est encadré en orange foncé.](/assets/images/help/repository/new-branch.png)

Maintenant, vous avez deux branches, `main` et `readme-edits`. Pour le moment, elles sont strictement identiques. Par la suite, vous allez ajouter des modifications à la nouvelle branche `readme-edits`.

## Étape 3 : Apporter et commiter des modifications

Lorsque vous avez créé une branche à l’étape précédente, GitHub vous avez amené à la page de codes de votre nouvelle `readme-edits` branche, qui est une copie de `main`.

Vous pouvez apporter et enregistrer des modifications dans les fichiers de votre dépôt. Sur GitHub, les modifications enregistrées sont appelées validations. Chaque commit est associé à un message de commit qui décrit pourquoi une modification particulière a été apportée. Les messages de commit capturent l'historique de vos modifications afin que d'autres contributeurs puissent comprendre ce que vous avez fait et pourquoi.

1. Sous la branche `readme-edits` que vous avez créée, cliquez sur le fichier `README.md`.
2. Pour modifier le fichier, cliquez sur <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit file" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>.
3. Dans l'éditeur, présentez-vous en quelques mots.
4. Cliquez sur **Valider les changements**.
5. Dans la zone Commiter les modifications, écrivez un message de commit qui décrit vos modifications.
6. Cliquez sur **Valider les changements**.

Ces modifications sont uniquement apportées au fichier LISEZ-MOI de votre branche `readme-edits`. Le contenu de cette branche est donc maintenant différent de celui de `main`.

## Étape 4 : Ouvrir une demande de tirage

Maintenant que vous avez des modifications dans une branche issue de `main`, vous pouvez ouvrir une pull request.

Les pull requests sont au cœur de la collaboration sur GitHub. Quand vous ouvrez une pull request, vous proposez vos modifications et demandez à quelqu'un de les examiner, d'accepter (pull) votre contribution et de les fusionner dans sa branche. Les requêtes de tirage affichent les différences entre le contenu des deux branches. Les modifications, ajouts et suppressions sont affichés dans des couleurs différentes.

Dès que vous effectuez un commit, vous pouvez ouvrir une pull request et démarrer une discussion, avant même que le code ne soit terminé.

Dans cette étape, vous allez ouvrir une pull request dans votre propre référentiel, puis la fusionner vous-même. C’est un excellent moyen de pratiquer le GitHub flux avant de travailler sur des projets plus volumineux.

1. Cliquez sur l'onglet **Requêtes de tirage** de votre dépôt `hello-world`.

2. Cliquez sur **Nouvelle pull request**.

3. Dans la zone **Exemples de comparaisons**, sélectionnez la branche que vous avez créée, `readme-edits`, pour la comparer à `main` (l'originale).

4. Examinez vos modifications dans les différences figurant dans la page Comparer pour vérifier qu'elles correspondent bien à ce que vous voulez soumettre.

   ![Capture d'écran d'un diff du fichier README.md. 3 lignes rouges listent le texte en cours de suppression, tandis que 3 lignes vertes listent le texte en cours d'ajout.](/assets/images/help/repository/diffs.png)

5. Cliquez sur **Créer une pull request**.

6. Donnez un titre à votre pull request et décrivez brièvement vos modifications. Vous pouvez inclure des emojis et faire glisser des images et des gifs.

7. Cliquez sur **Créer une pull request**.

### Examen d'une pull request

Lorsque vous commencez à collaborer avec d’autres personnes, c’est le moment où vous demandez leur révision. Cela permet à vos collaborateurs de commenter ou de proposer des modifications à votre pull request avant la fusion des modifications dans la branche `main`.

Nous ne couvrirons pas l'examen des requêtes de tirage dans ce tutoriel, mais si vous souhaitez en savoir plus, consultez [Revues de demande de tirage](/fr/enterprise-server@3.21/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews). Vous pouvez également essayer le [GitHub Skills](https://skills.github.com/) cours « Révision des pull requests ».

## Étape 5 : Fusionnez votre pull request

Dans cette dernière étape, vous allez fusionner votre branche `readme-edits` dans la branche `main`. Une fois que vous avez fusionné votre pull request, les modifications apportées à votre branche `readme-edits` seront incorporées dans `main`.

Parfois, une pull request peut apporter des modifications au code qui entrent en conflit avec le code existant sur `main`. S’il existe des conflits, GitHub vous alerte sur le code en conflit et empêche la fusion jusqu’à ce que les conflits soient résolus. Vous pouvez faire un commit qui résout les conflits ou utiliser des commentaires dans la requête de tirage pour discuter des conflits avec votre équipe.

Lors de cette démo, vous ne devriez pas avoir de conflits. Vous êtes donc prêt à fusionner votre branche dans la branche principale.

1. En bas de la demande de tirage, cliquez sur **Fusionner la demande de tirage** pour fusionner les modifications dans `main`.
2. Cliquez sur **Confirmer la fusion**. Vous allez recevoir un message indiquant que la demande a été correctement fusionnée et fermée.
3. Cliquez sur **Supprimer la branche**. Maintenant que votre pull request est fusionnée et que vos modifications sont sur `main`, vous pouvez supprimer en toute sécurité la branche `readme-edits`. Si vous voulez apporter d'autres modifications à votre projet, vous pouvez toujours créer une branche et répéter ce processus.
4. Cliquez à nouveau sur l’onglet **Code** de votre référentiel `hello-world` pour afficher vos modifications publiées sur `main`.

## Conclusion

En terminant ce tutoriel, vous avez appris à créer un projet et à créer une pull request sur GitHub.

Dans ce cadre, nous avons appris à :

* Créer un référentiel.
* Démarrer et gérer une nouvelle branche.
* Modifiez un fichier et validez ces modifications sur GitHub.
* Ouvrir et fusionner une pull request.

## Étapes suivantes

* Consultez votre profil GitHub et vous y verrez votre travail apparaître sur votre graphique des contributions.
* Si vous souhaitez pratiquer à nouveau les compétences que vous avez apprises dans ce tutoriel, essayez le [GitHub Skills](https://skills.github.com/) cours « Introduction à GitHub».
* Personnalisez votre profil et découvrez une syntaxe Markdown de base pour l’écriture GitHub, consultez [Personnalisez votre profil](/fr/enterprise-server@3.21/account-and-profile/tutorials/personalize-your-profile).

## Lectures complémentaires

* [flux de GitHub](/fr/enterprise-server@3.21/get-started/using-github/github-flow)