Skip to main content

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.

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, cliquez sur votre photo de profil, puis sur Vos organisations. Vos organisations dans le menu Profil 2. Cliquez sur le nom de votre organisation. Nom de l’organisation dans la liste des organisations

  2. Sous le nom de votre organisation, cliquez sur Projets. Capture d’écran montrant l’onglet « Projets ».

  3. Cliquez sur Nouveau projet. Capture d’écran montrant le bouton Nouveau projet.

  4. Quand vous êtes invité à sélectionner un modèle, cliquez sur un modèle ou, pour commencer avec un projet vide, cliquez sur Tableau ou sur Panneau. Ensuite, cliquez sur Créer.

    Capture d’écran montrant la fenêtre modale de sélection du modèle

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. Photo de profil

  2. Dans votre profil, cliquez sur Projets. Capture d’écran montrant l’onglet « Projets ».

  3. Cliquez sur Nouveau projet. Nouveau projet

  4. Quand vous êtes invité à sélectionner un modèle, cliquez sur un modèle ou, pour commencer avec un projet vide, cliquez sur Tableau ou sur Panneau. Ensuite, cliquez sur Créer.

    Capture d’écran montrant la fenêtre modale de sélection du modèle

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 l’icône du menu.
  3. Dans le menu, cliquez sur Paramètres pour accéder aux paramètres du projet. Capture d’écran montrant l’élément de menu « Paramètres »
  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. Capture d’écran montrant les paramètres « Ajouter ma description »
  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. Capture d’écran montrant le bouton « Enregistrer » pour le fichier README d’un projet

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 inférieure du projet, à côté de l’icône . Capture d’écran montrant la ligne inférieure pour ajouter un élément
  2. Collez l’URL du problème ou de la demande de tirage. Capture d’écran montrant le collage d’une URL de problème pour l’ajouter au projet
  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 projet ».

Ajout de brouillons de problèmes à votre projet

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

  1. Placez votre curseur dans la ligne inférieure du projet, à côté de l’icône . Capture d’écran montrant la ligne inférieure pour ajouter un élément
  2. Entrez votre idée, puis appuyez sur Entrée. Capture d’écran montrant le collage d’une URL de problème pour l’ajouter au projet
  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 montrant le bouton Nouveau champ
  2. Cliquez sur Nouveau champ. Capture d’écran montrant l’élément de menu Nouveau champ
  3. Tapez le nom de votre nouveau champ. Capture d’écran montrant le nom du champ
  4. Sélectionner Itération Capture d’écran montrant l’option 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. Capture d’écran montrant la durée de l’itération
  6. Cliquez sur Enregistrer. Capture d’écran montrant le bouton 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 montrant le bouton Nouveau champ
  2. Cliquez sur Nouveau champ. Capture d’écran montrant l’élément de menu Nouveau champ
  3. Tapez le nom de votre nouveau champ. Capture d’écran montrant le nom du champ
  4. Sélectionner Choix unique Capture d’écran montrant l’option Choix unique
  5. Sous « Options », tapez la première option, « High ». Capture d’écran montrant l’option Choix unique
  6. Pour ajouter des champs supplémentaires, pour « Medium » et « Low », cliquez sur Ajouter une option.
  7. Cliquez sur Enregistrer. Capture d’écran montrant le bouton Enregistrer

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

Exemples de priorités

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 l’icône du menu de vues.
  2. Cliquez sur Regrouper. Capture d’écran montrant l’élément de menu Groupe
  3. Cliquez sur Priorité. Capture d’écran montrant le menu Groupe

À 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.

Déplacer un problème entre des groupes

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 l’icône du menu de vues.
  2. Cliquez sur Save changes. Capture d’écran montrant l’élément de menu Enregistrer

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.

Exemple d’état

Ensuite, créez une vue.

  1. À droite de vos vues existantes, cliquez sur Nouvelle vue Capture d’écran montrant le menu du champ de colonne

Ensuite, passez à la disposition de tableau.

  1. Cliquez sur à côté du nom de la vue actuellement ouverte. Capture d’écran montrant l’icône du menu de vues.
  2. Sous « Disposition », cliquez sur Tableau. Capture d’écran montrant l’option Disposition

Exemples de priorités

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 l’icône du menu de vues.
  2. Cliquez sur Save changes. Capture d’écran montrant l’élément de menu Enregistrer

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 l’icône du menu de vues.
  2. Cliquez sur Renommer la vue. Capture d’écran montrant l’élément de menu Renommer
  3. Tapez le nouveau nom de votre vue.
  4. Pour enregistrer les changements, appuyez sur Retour.

Exemples de priorités

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 l’icône du menu.

  3. Dans le menu, cliquez sur Workflows. Capture d’écran montrant l’élément de menu « Workflows »

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

    Capture d’écran du workflow d’ajout automatique

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

    Capture d’écran montrant le bouton de modification

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

    Capture d’écran montrant la sélection du dépôt

  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.

    Capture d’écran montrant la sélection du dépôt

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

    Capture d’écran des workflows d’ajout automatique

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 l’icône du menu.
  2. Dans le menu, cliquez sur Workflows. Capture d’écran montrant l’élément de menu « Workflows »
  3. Sous Workflows par défaut, cliquez sur Élément ajouté au projet. Capture d’écran montrant les workflows par défaut
  4. À côté de Quand, vérifiez que issues et pull requests sont sélectionnés. Capture d’écran montrant la configuration « quand » pour un workflow
  5. À côté de Définir, sélectionnez État : À faire. Capture d’écran montrant la configuration « définir » pour un workflow
  6. Cliquez sur le bouton bascule Désactivé pour activer le workflow. Capture d’écran montrant la commande « activer » pour un workflow

Pour aller plus loin