Démarrage rapide avec les Projects

Testez la vitesse, la flexibilité et la personnalisation des Projects en créant un projet dans ce guide interactif.

Dans cet article

Introduction

Ce guide montre comment utiliser des Projects pour planifier et suivre le travail. Dans ce guide, vous allez créer un projet et ajouter un champ personnalisé pour suivre les priorités de vos tâches. Vous apprendrez à créer des vues enregistrées qui vous aideront à communiquer les priorités et la progression avec vos collaborateurs. Vous allez également configurer des workflows intégrés pour gérer les éléments de votre projet.

Prérequis

Vous pouvez créer un projet d’organisation ou un projet d’utilisateur. Pour créer un projet d’organisation, vous avez besoin d’une organisation GitHub. Pour plus d’informations sur la création d’une organisation, consultez « Création d’une organisation à partir de zéro ».

Dans ce guide, vous allez ajouter à votre nouveau projet des problèmes existants issus de dépôts vous appartenant (projets d’utilisateur) ou appartenant à votre organisation (projets d’organisation). Pour plus d’informations sur la création de problèmes, consultez « Création d’un problème ».

Création d’un projet

Tout d’abord, créez un projet d’organisation ou un projet d’utilisateur.

Création d’un projet d’organisation

  1. Dans l’angle supérieur droit de GitHub.com, sélectionnez votre photo de profil, puis sur Vos organisations.

    Capture d’écran du menu déroulant sous l’image de profil de @octocat. « Vos organisations » est présenté en orange foncé.

  2. Cliquez sur le nom de votre organisation.

  3. Sous le nom de votre organisation, cliquez sur Projets.

    Capture d’écran montrant les onglets du profil. L’onglet « Projets » est mis en évidence avec un encadré orange.

  4. Cliquez sur Nouveau projet.

  5. Sélectionnez le type de projet ou de modèle que vous souhaitez utiliser.

    • Pour créer un projet vide, sous « Partir de zéro », cliquez sur Table, Feuille de route, ou Panneau.
    • Pour créer un projet à partir d’un modèle, cliquez sur le modèle que vous souhaitez utiliser. Vous pouvez sélectionner parmi les modèles intégrés organisés par GitHub, les modèles créés par votre organisation et ceux recommandés qui ont été choisis par votre organisation.

  6. Si vous avez éventuellement sélectionné un modèle, examinez les champs, les vues, les flux de travail et les aperçus qui seront créés.

  7. Dans la zone de texte sous « Nom du projet », tapez un nom pour votre nouveau projet.

  8. Cliquez sur Créer un projet.

Création d’un projet d’utilisateur

  1. Dans l’angle supérieur droit de GitHub.com, cliquez sur votre photo de profil, puis sur Votre profil.

    Capture d’écran du menu déroulant sous l’image de profil de @octocat. « Votre profil » est délimité en orange foncé.

  2. Dans votre profil, cliquez sur Projets.

    Capture d’écran montrant les onglets du profil. L’onglet « Projets » est mis en évidence avec un encadré orange.

  3. Cliquez sur Nouveau projet.

  4. Sélectionnez le type de projet ou de modèle que vous souhaitez utiliser.

    • Pour créer un projet vide, sous « Partir de zéro », cliquez sur Table, Feuille de route, ou Panneau.
    • Pour créer un projet à partir d’un modèle, cliquez sur le modèle intégré que vous souhaitez utiliser.

  5. Si vous avez éventuellement sélectionné un modèle, examinez les champs, les vues, les flux de travail et les aperçus qui seront créés.

  6. Dans la zone de texte sous « Nom du projet », tapez un nom pour votre nouveau projet.

  7. Cliquez sur Créer un projet.

Définition de la description de votre projet et du fichier README

Vous pouvez définir la description et le fichier README de votre projet pour partager l’objectif de votre projet, fournir des instructions sur l’utilisation du projet et ajouter tous les liens pertinents.

  1. Accédez à votre projet.

  2. En haut à droite, cliquez sur pour ouvrir le menu.

    Capture d’écran montrant la barre de menus d’un projet. L’icône de menu est mise en évidence avec un encadré orange.

  3. Dans le menu, cliquez sur Paramètres pour accéder aux paramètres du projet.

  4. Pour ajouter une brève description à votre projet, sous « Ajouter une description », tapez votre description dans la zone de texte et cliquez sur Enregistrer.

  5. Pour mettre à jour le fichier README de votre projet, sous « README », tapez votre contenu dans la zone de texte.

  6. Pour enregistrer les changements de votre README, cliquez sur Enregistrer.

Si vous voulez voir la description et le README de votre projet, et y faire des changements rapides, accédez à votre projet et cliquez sur en haut à droite.

Ajout de problèmes à votre projet

Ensuite, ajoutez quelques problèmes à votre projet.

  1. Placez votre curseur dans la ligne de bas du projet, à côté de .

    Capture d’écran montrant la ligne inférieure d’une vue de tableau. Le champ « Ajouter un élément » est mis en évidence avec un encadré orange.

  2. Collez l’URL du problème ou de la demande de tirage.

  3. Pour ajouter le problème ou la demande de tirage, appuyez sur Retour.

Répétez les étapes ci-dessus pour ajouter plusieurs problèmes à votre projet.

Pour plus d’informations et d’autres moyens d’ajouter des problèmes à votre projet ou pour découvrir les autres éléments que vous pouvez ajouter à votre projet, consultez « Ajout d’éléments à votre project ».

Ajout de brouillons de problèmes à votre projet

Ensuite, ajoutez un brouillon de problème à votre projet.

  1. Placez votre curseur dans la ligne de bas du projet, à côté de .

    Capture d’écran montrant la ligne inférieure d’une vue de tableau. Le champ « Ajouter un élément » est mis en évidence avec un encadré orange.

  2. Entrez votre idée, puis appuyez sur Entrée.

  3. Pour ajouter du texte de corps, cliquez sur le titre du brouillon de problème. Dans la zone d’entrée Markdown qui s’affiche, entrez le texte du corps du brouillon de problème, puis cliquez sur Enregistrer.

Ajout d’un champ d’itération

Ensuite, créez un champ d’itération pour vous permettre de planifier et de suivre votre travail sur des périodes de temps répétées. Les itérations peuvent être configurées pour répondre à la façon dont vous et votre équipe travaillez, avec des durées personnalisables et la possibilité d’insérer des arrêts.

  1. Dans la vue table, dans le titre du champ le plus à droite, cliquez sur .
    Capture d’écran d’un projet. Le bouton « Ajouter un champ » est mis en évidence avec un encadré orange.
  2. Cliquez sur Nouveau champ.
  3. En haut de la liste déroulante, tapez le nom de votre nouveau champ.
  4. Sélectionner Itération
  5. Pour modifier la durée de chaque itération, tapez un nouveau nombre, sélectionnez la liste déroulante, puis cliquez sur Jours ou Semaines.
  6. Cliquez sur Enregistrer.

Création d’un champ pour suivre la priorité

Maintenant, créez un champ personnalisé appelé Priority contenant les valeurs : High, Medium ou Low.

  1. Dans la vue table, dans le titre du champ le plus à droite, cliquez sur .
    Capture d’écran d’un projet. Le bouton « Ajouter un champ » est mis en évidence avec un encadré orange.
  2. Cliquez sur Nouveau champ.
  3. En haut de la liste déroulante, tapez le nom de votre nouveau champ.
  4. Sélectionnez Sélection unique.
  5. Sous « Options », tapez la première option, « High ».
  6. Pour ajouter des champs supplémentaires, pour « Medium » et « Low », cliquez sur Ajouter une option.
  7. Cliquez sur Enregistrer.

Spécifiez une priorité pour tous les problèmes de votre projet.

Capture d’écran montrant une liste de problèmes, chacun avec une priorité « Faible », « Moyen » ou « Élevé » dans le champ « Priorité ».

Regroupement de problèmes par priorité

Ensuite, regroupez tous les éléments de votre projet par priorité pour identifier plus facilement les éléments prioritaires.

  1. Cliquez sur à côté du nom de la vue actuellement ouverte.

    Capture d’écran montrant les onglets en haut d’un projet. L’icône du menu de vue est mise en évidence avec un encadré orange.

  2. Cliquez sur Grouper.

  3. Cliquez sur Priorité.

À présent, déplacez les problèmes entre les groupes pour changer leur priorité.

  1. Choisissez un problème.
  2. Faites glisser-déposer le problème dans un groupe avec une priorité différente. Lorsque vous procédez ainsi, la priorité du problème est remplacée par celle de son nouveau groupe.

Enregistrement de la vue des priorités

Si vous avez regroupé vos problèmes par priorité à l’étape précédente, un indicateur apparaît dans votre projet pour montrer que la vue a été modifiée. Enregistrez ces modifications pour que vos collaborateurs voient également les tâches regroupées par priorité.

  1. Cliquez sur à côté du nom de la vue actuellement ouverte.

    Capture d’écran montrant les onglets en haut d’un projet. L’icône du menu de vue est mise en évidence avec un encadré orange.

  2. Cliquez sur Save changes.

Vous pouvez partager l’URL avec votre équipe pour que tout le monde ait connaissance des priorités du projet.

Quand une vue est enregistrée, toute personne qui ouvre le projet voit la vue enregistrée. Ici, vous avez effectuez un regroupement par priorité, mais vous pouvez également ajouter d’autres modificateurs tels qu’un tri, un filtre ou une disposition. Ensuite, vous allez créer une vue avec la disposition modifiée.

Ajout d’une disposition de tableau

Pour voir la progression des problèmes de votre projet, vous pouvez passer à la disposition de tableau.

La disposition de tableau étant basée sur le champ d’état, spécifiez un état pour chaque problème de votre projet.

Ensuite, créez une vue.

  1. À droite de vos affichages existants, cliquez sur Nouvelle vue
    Capture d’écran montrant les onglets d’affichage en haut d’un projet. Le bouton « Nouvelle vue » est mis en évidence avec un encadré orange.

Ensuite, passez à la disposition de tableau.

  1. Cliquez sur à côté du nom de la vue actuellement ouverte.

    Capture d’écran montrant les onglets en haut d’un projet. L’icône du menu de vue est mise en évidence avec un encadré orange.

  2. Sous « Disposition », cliquez sur Tableau.

Quand vous changez la disposition, un indicateur apparaît dans votre projet pour montrer que la vue a été modifiée. Enregistrez cette vue pour que vous et vos collaborateurs puissiez y accéder facilement à l’avenir.

  1. Cliquez sur à côté du nom de la vue actuellement ouverte.

    Capture d’écran montrant les onglets en haut d’un projet. L’icône du menu de vue est mise en évidence avec un encadré orange.

  2. Cliquez sur Save changes.

Pour indiquer l’objectif de la vue, donnez-lui un nom descriptif.

  1. Cliquez sur à côté du nom de la vue actuellement ouverte.

    Capture d’écran montrant les onglets en haut d’un projet. L’icône du menu de vue est mise en évidence avec un encadré orange.

  2. Cliquez sur Renommer la vue.

  3. Tapez le nouveau nom de votre vue.

  4. Pour enregistrer les changements, appuyez sur Retour.

Configurer l’automatisation intégrée

Vous configurez ensuite le workflow d’ajout automatique pour ajouter automatiquement les problèmes ouverts dans un dépôt avec une étiquette spécifique à votre projet.

  1. Accédez à votre projet.

  2. En haut à droite, cliquez sur pour ouvrir le menu.

    Capture d’écran montrant la barre de menus d’un projet. L’icône de menu est mise en évidence avec un encadré orange.

  3. Dans le menu, cliquez sur Workflows.

  4. Dans la liste « Workflows par défaut », cliquez sur Ajouter automatiquement au projet.

  5. Pour commencer à modifier le workflow, cliquez sur Modifier en haut à droite.

    Capture d’écran montrant la barre de menus des workflows. Le bouton « Modifier » est mis en surbrillance avec un rectangle orange.

  6. Sous « Filtres », sélectionnez le dépôt à partir duquel vous souhaitez ajouter des éléments.

  7. En regard de la sélection du dépôt, entrez les critères de filtre auxquels vous les éléments doivent correspondre pour être automatiquement ajoutés à votre projet. Par exemple, pour identifier tous les problèmes et demandes de tirage ouverts avec l’étiquette « bug », utilisez is:issue,pr label:bug.

  8. Pour activer le nouveau workflow, cliquez sur Enregistrer et activer le workflow.

Enfin, ajoutez un workflow intégré pour définir l’état sur À faire quand un élément est ajouté à votre projet.

  1. En haut à droite, cliquez sur pour ouvrir le menu.
    Capture d’écran montrant la barre de menus d’un projet. L’icône de menu est mise en évidence avec un encadré orange.
  2. Dans le menu, cliquez sur Workflows.
  3. Sous Workflows par défaut, cliquez sur Élément ajouté au projet.
  4. À côté de Quand, vérifiez que issues et pull requests sont sélectionnés.
  5. À côté de Définir, sélectionnez État : À faire.
  6. Cliquez sur le bouton bascule Désactivé pour activer le workflow.

Pour aller plus loin