# Démarrage rapide pour les pull requests

Proposez votre première modification et menez-la jusqu’à son premier commit, puis jusqu’à une pull request fusionnée.

Une pull request propose des modifications sur une branche distincte de la base de code principale afin que d’autres puissent examiner les modifications avant qu’elles ne soient fusionnées. Ce guide de démarrage rapide vous montre la manière la plus simple de créer une pull request. Vous allez créer une branche, effectuer des modifications et les valider, ouvrir une pull request, répondre aux retours et fusionner.

Vous pouvez suivre le suivi sur le GitHub site web ou avec GitHub CLI en sélectionnant l’un des onglets ci-dessus.

## Branche ou duplication du référentiel

Vous commencerez par créer un endroit isolé pour travailler.

<div class="ghd-tool webui">

1. Sur GitHub, accédez à la page principale du référentiel pour lequel vous souhaitez proposer des modifications.
2. Le cas échéant, si vous n’avez pas d’accès en écriture, vous aurez besoin d’un fork. Cliquez sur **Fork** dans le coin supérieur droit et suivez les étapes. Ensuite, poursuivez dans votre fourche du dépôt.
3. Cliquez sur le menu sélecteur de branche en haut de la liste des fichiers. Il dit probablement **principal**. Tapez un nouveau nom de branche, puis cliquez sur **Créer un *nouveau nom de branche* à partir du nom principal**.

</div>

<div class="ghd-tool cli"> 

1. Pour l’utiliser GitHub CLI, vous devez d’abord l’installer. Consultez « [Démarrage rapide de l’interface CLI GitHub](/fr/enterprise-server@3.17/github-cli/github-cli/quickstart) ».

2. Clonez le référentiel. Vous pouvez aussi dupliquer le dépôt et le cloner localement en même temps.

* Si vous avez accès en écriture au référentiel, clonez le référentiel :

  ```shell
  gh repo clone OWNER/REPO
  ```

* Si vous n’avez pas d’accès en écriture, vous créerez d’abord un **fork**, puis vous le clonerez dans la foulée.

  ```shell
  gh repo fork OWNER/REPO --clone
  ```

1. Accédez au répertoire de référentiel cloné.

   ```shell
   cd REPO
   ```

2. Créez et basculez vers une nouvelle branche.

   ```shell
   git checkout -b YOUR-BRANCH-NAME
   ```

</div>

## Créer ou modifier votre code

Apportez vos modifications dans la branche. Pour votre première pull request, veillez à ce que la modification soit simple et ciblée. Les pull requests de petite taille sont plus rapides à examiner et plus faciles à fusionner.

Essayez l’une des opérations suivantes pour apporter vos modifications :

* Modifiez les fichiers localement dans votre IDE ou dans un éditeur de texte.
* Modifiez directement un fichier sur GitHub en y accédant, puis en cliquant sur <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit this 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>.

## Effectuez des commits fréquents

Enregistrez votre travail sous forme de petits commits pertinents. Chaque validation enregistre un instantané et un message décrivant la modification.

<div class="ghd-tool cli">

```shell
git add .
git commit -m "Describe your change"
git push --set-upstream origin YOUR-BRANCH-NAME
```

</div>

<div class="ghd-tool webui">

Lorsque vous modifiez un fichier sur GitHub et que vous êtes prêt à valider, vous saisissez un message de validation et validez directement sur votre branche.

1. Cliquez sur **Valider les modifications...**.
2. Dans la zone **de message De validation** , entrez une brève description des modifications que vous avez apportées.
3. Sélectionnez la branche sur laquelle vous travaillez.
4. Cliquez sur **Proposer des modifications**.

Votre modification sera ajoutée et validée dans la branche.

</div>

## Ouvrez votre pull request

Lorsque votre branche contient les modifications que vous souhaitez proposer, ouvrez une pull request vers la branche de base.

<div class="ghd-tool webui">

1. Sur la page principale du dépôt, cliquez sur **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-pull-request" aria-label="The pull request icon" role="img"><path d="M1.5 3.25a2.25 2.25 0 1 1 3 2.122v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.25 2.25 0 0 1 1.5 3.25Zm5.677-.177L9.573.677A.25.25 0 0 1 10 .854V2.5h1A2.5 2.5 0 0 1 13.5 5v5.628a2.251 2.251 0 1 1-1.5 0V5a1 1 0 0 0-1-1h-1v1.646a.25.25 0 0 1-.427.177L7.177 3.427a.25.25 0 0 1 0-.354ZM3.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm0 9.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm8.25.75a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Z"></path></svg> Pull requests**, puis sur **New pull request**.
2. Pour la branche **de base** , la branche principale est probablement déjà sélectionnée et est généralement la branche de base dans laquelle vous allez fusionner.
3. Pour la branche **de comparaison** , sélectionnez la branche qui contient vos modifications.
4. Cliquez sur **Créer une pull request**.
5. Entrez un titre et une description qui explique ce que vous avez changé et pourquoi.
6. Vous pouvez créer une pull request prête à être examinée ou une pull request en brouillon.

* Si tout est prêt pour la révision, cliquez sur **Créer une pull request**.
* Pour partager un travail en cours, utilisez la liste déroulante et sélectionnez **Créer une demande de tirage provisoire**.

</div>

<div class="ghd-tool cli">

Vous pouvez créer une pull request prête à être examinée ou en brouillon.

* S’il est prêt à être examiné :

  ```shell
  gh pr create
  ```

* Pour partager un travail en cours

  ```shell
  gh pr create --draft
  ```

Ensuite, suivez les instructions pour définir la branche de base, le titre et la description.

</div>

Si vous effectuez d’autres commits sur la même branche, ils seront automatiquement ajoutés à votre pull request.

## Demander une révision

Pour demander une révision via la zone **Réviseurs** , vous avez besoin d’un accès en écriture au référentiel et vous pouvez demander une révision auprès d’une personne ou d’une équipe disposant d’un accès en lecture au référentiel. Si vous demandez une révision, la personne ou l’équipe reçoit une notification. Dans certains cas, vous verrez des réviseurs suggérés que vous pourrez sélectionner.

Si la zone **Réviseurs** n’est pas disponible pour vous, vous pouvez :

* Consultez le fichier README du dépôt pour connaître ses consignes concernant les revues de pull request, puis suivez-les.
* Si vous connaissez une personne qui peut faire la relecture pour vous, contactez-la et partagez le lien de votre pull request.

## Répondre aux commentaires de révision

Les examinateurs peuvent commenter, suggérer des modifications ou demander des modifications avant qu’une pull request puisse être fusionnée.

* Pour accepter la suggestion d’un réviseur, cliquez sur **Valider la suggestion** (ou plusieurs lots, puis cliquez sur **Valider les suggestions**).
* Pour apporter des modifications plus larges, modifiez votre code et envoyez de nouvelles validations à la même branche. La pull request se met automatiquement à jour et relancera les vérifications nécessaires.
* Marquez chaque conversation comme **résolue** une fois que vous l’avez traitée.

## Fusionner et déployer

Une fois les examens requis et les vérifications d’état réussis, fusionnez la pull request pour intégrer vos modifications dans la branche de base. Si vous décidez de ne pas fusionner les modifications, vous pouvez fermer la pull request à la place.

> \[!TIP]
> Différents référentiels peuvent avoir des exigences différentes pour la fusion. Passez en revue les conseils pertinents et suivez ses instructions.

<div class="ghd-tool webui">

1. En bas de la demande de tirage, cliquez sur **Fusionner la demande de tirage**.
2. Cliquez sur **Confirmer** pour terminer la fusion.
3. (Facultatif) Supprimez la branche source pour garder le dépôt propre.

</div>

<div class="ghd-tool cli">

```shell
gh pr merge
```

Suivez les instructions pour choisir une méthode de fusion et éventuellement supprimer la branche.

</div>

## Étapes suivantes

Après votre première pull request, essayez de relire le travail de quelqu’un d’autre. Consultez « [Démarrage rapide pour l’examen des pull requests](/fr/enterprise-server@3.17/pull-requests/get-started/reviewing-pull-requests-quickstart) ».

## Lectures complémentaires

* [Writing code for a project](/fr/enterprise-server@3.17/pull-requests/concepts/writing-code-for-a-project)
* [Requêtes de tirage](/fr/enterprise-server@3.17/pull-requests/reference/pull-requests)