Introduction
Ce guide montre comment utiliser des Projects pour planifier et suivre le travail. Dans ce guide, vous allez créer un nouveau projet, personnaliser les vues et ajouter des champs personnalisés afin de gérer le backlog de l’équipe, la planification des itérations et la feuille de route de l’équipe pour communiquer les priorités et les progrès à vos collaborateurs. Vous allez également configurer des flux de travail intégrés pour gérer automatiquement les éléments de votre projet et des graphiques pour visualiser 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
-
Dans le coin supérieur droit de GitHub, sélectionnez votre photo de profil, puis cliquez sur Vos organisations.
-
Cliquez sur le nom de votre organisation.
-
Sous le nom de votre organisation, cliquez sur Projets.
-
Cliquez sur Nouveau projet.
-
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.
-
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.
-
Dans la zone de texte sous « Nom du projet », tapez un nom pour votre nouveau projet.
-
Cliquez sur Créer un projet.
Création d’un projet d’utilisateur
-
En haut à droite de GitHub, cliquez sur votre photo de profil, puis sur Votre profil.
-
Dans votre profil, cliquez sur Projets.
-
Cliquez sur Nouveau projet.
-
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.
-
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.
-
Dans la zone de texte sous « Nom du projet », tapez un nom pour votre nouveau projet.
-
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.
-
Accédez à votre projet.
-
En haut à droite, cliquez sur pour ouvrir le menu.
-
Dans le menu, cliquez sur Paramètres pour accéder aux paramètres du projet.
-
Pour ajouter une brève description à votre projet, sous « Ajouter une description », tapez votre description dans la zone de texte et cliquez sur Enregistrer.
-
Pour mettre à jour le fichier README de votre projet, sous « README », tapez votre contenu dans la zone de texte.
- Vous pouvez mettre en forme votre README avec Markdown. Pour plus d’informations, consultez « Syntaxe de base pour l’écriture et la mise en forme ».
- Pour basculer entre la zone de texte et un aperçu de vos changements, cliquez sur ou .
-
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 d’éléments à votre projet
Ensuite, ajoutez quelques éléments à votre projet.
-
Placez votre curseur dans la ligne de bas du projet, à côté de .
-
Collez l’URL du problème ou de la demande de tirage.
-
Pour ajouter le problème ou la demande de tirage, appuyez sur Retour.
Répétez les étapes ci-dessus plusieurs fois pour ajouter plusieurs éléments à 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.
-
Placez votre curseur dans la ligne de bas du projet, à côté de .
-
Entrez votre idée, puis appuyez sur Entrée.
-
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 de champs
Ensuite, créez des champs personnalisés pour gérer l’itération, la priorité et les estimations des éléments de votre projet.
Création d’un champ d’itération
Créez un champ d’itération afin de pouvoir planifier et 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.
- Dans la vue table, dans le titre du champ le plus à droite, cliquez sur .
- Cliquez sur Nouveau champ.
- En haut de la liste déroulante, tapez le nom de votre nouveau champ.
- Sélectionner Itération
- 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.
- Cliquez sur Enregistrer.
Spécifiez une itération pour tous les éléments de votre projet.
Création d’un champ de priorité
Maintenant, créez un champ personnalisé appelé Priority
contenant les valeurs : High
, Medium
ou Low
.
- Dans la vue table, dans le titre du champ le plus à droite, cliquez sur .
- Cliquez sur Nouveau champ.
- En haut de la liste déroulante, tapez le nom de votre nouveau champ.
- Sélectionnez Sélection unique.
- Sous « Options », tapez la première option, « High ».
- Pour ajouter des champs supplémentaires, pour « Medium » et « Low », cliquez sur Ajouter une option.
- Cliquez sur Enregistrer.
Spécifiez une priorité pour tous les éléments de votre projet.
Création d’un champ d’estimation
Créez un champ personnalisé nommé Estimate
pour suivre la complexité de chaque élément.
- Dans la vue table, dans le titre du champ le plus à droite, cliquez sur .
- Cliquez sur Nouveau champ.
- En haut de la liste déroulante, tapez le nom de votre nouveau champ.
- Sélectionnez Nombre.
- Cliquez sur Enregistrer.
Spécifiez une estimation pour tous les éléments de votre projet.
Création de vues
Créez des vues pour visualiser vos éléments dans une table, un tableau et une feuille de route.
Pour plus d’informations sur la personnalisation des vues, consultez Personnalisation des vues dans votre project.
Création d’un backlog d’équipe
Vous pouvez utiliser une disposition en table pour visualiser le backlog de votre équipe sous forme de feuille de calcul, ce qui vous permet de consulter de nombreux champs et d’apporter des modifications.
Sélectionnez les champs visibles pour votre vue afin de communiquer les priorités et la progression du backlog de votre équipe.
-
Dans la vue table, dans le titre du champ le plus à droite, cliquez sur .
-
Sous « Champs masqués », cliquez sur Statut, Personnes responsables, Demandes de tirage liées, Priorité et Estimation.
Ensuite, regroupez tous les éléments de votre projet par priorité pour identifier plus facilement les éléments prioritaires.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Cliquez sur Groupe.
-
Cliquez sur Priorité.
À présent, déplacez des éléments entre des groupes pour modifier leur priorité.
- Choisissez un élément.
- Glissez-déposez l’élément dans un autre groupe de priorité. Lorsque vous effectuez cette opération, la priorité de l’élément change pour correspondre à celle de son nouveau groupe.
Vous pouvez également afficher la somme du champ Estimate
pour chaque groupe de priorité.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Cliquez sur Somme du champ.
-
Sélectionnez Estimation.
Lorsque vous avez regroupé vos éléments par priorité et ajouté une somme de champ lors des étapes précédentes, votre projet a affiché un indicateur pour signaler que la vue avait été modifiée. Enregistrez ces modifications pour que vos collaborateurs voient également les tâches regroupées par priorité.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
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.
Enfin, pour indiquer l’objectif de la vue, donnez-lui un nom descriptif.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Cliquez sur Renommer la vue.
-
Tapez le nouveau nom de votre vue.
-
Pour enregistrer les changements, appuyez sur Retour.
Ensuite, vous allez créer de nouvelles vues avec différentes dispositions.
Pour plus d’informations sur la personnalisation des tables, consultez Personnalisation de la disposition de tableau.
Création d’une vue de tableau pour l’itération hebdomadaire
Pour suivre la progression des éléments de votre projet dans un tableau Kanban, vous pouvez utiliser la disposition en tableau. La disposition en tableau est basée par défaut sur le champ du statut. Veuillez donc indiquer un statut pour chaque élément de votre projet.
Tout d’abord, créez une vue.
- À droite de vos affichages existants, cliquez sur Nouvelle vue
Ensuite, passez à la disposition en tableau.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Sous « Disposition », cliquez sur Tableau.
Pour indiquer l’objectif de la vue, donnez-lui un nom descriptif.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Cliquez sur Renommer la vue.
-
Tapez le nouveau nom de votre vue.
-
Pour enregistrer les changements, appuyez sur Retour.
Ajoutez un filtre pour iteration:@current
afin d’inclure uniquement les éléments de l’itération actuelle.
Vous pouvez également afficher la somme du champ Estimate
pour chaque colonne de statut.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Cliquez sur Somme du champ.
-
Sélectionnez Estimation.
Lorsque vous avez ajouté un filtre et une somme de champs lors des étapes précédentes, votre projet a affiché un indicateur pour signaler que la vue avait été modifiée. Enregistrez cette vue pour que vous et vos collaborateurs puissiez y accéder facilement à l’avenir.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Cliquez sur Save changes.
Pour plus d’informations sur la personnalisation des tableaux, consultez Personnalisation de la disposition en panneau.
Création d’une feuille de route d’équipe
Pour afficher les éléments de votre projet sur une chronologie, vous pouvez utiliser la disposition de la feuille de route. Les feuilles de route utilisent des champs de date et d’itération personnalisés pour positionner vos problèmes, vos demandes de tirage et vos brouillons sur une chronologie, ce qui vous permet de suivre le travail au fil du temps et d’observer les progrès réalisés.
Tout d’abord, créez une vue.
- À droite de vos affichages existants, cliquez sur Nouvelle vue
Ensuite, passez à la disposition en feuille de route.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Sous « Disposition », cliquez sur Feuille de route.
Vous pouvez ajouter des repères verticaux sur une feuille de route pour indiquer les jalons associés aux éléments de votre projet.
-
En haut à droite de votre feuille de route, cliquez sur Marqueurs.
-
Dans le menu, sélectionnez les marqueurs que vous souhaitez afficher sur votre feuille de route.
Après avoir ajouté des repères, votre projet a affiché un indicateur 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.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Cliquez sur Save changes.
Pour indiquer l’objectif de la vue, donnez-lui un nom descriptif.
-
Cliquez sur à côté du nom de la vue actuellement ouverte.
-
Cliquez sur Renommer la vue.
-
Tapez le nouveau nom de votre vue.
-
Pour enregistrer les changements, appuyez sur Retour.
Pour plus d’informations sur la personnalisation des feuilles de route, consultez Personnalisation de la disposition en feuille de route.
Configuration de 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.
-
Accédez à votre projet.
-
En haut à droite, cliquez sur pour ouvrir le menu.
-
Dans le menu, cliquez sur Workflows.
-
Dans la liste « Workflows par défaut », cliquez sur Ajouter automatiquement au projet.
-
Pour commencer à modifier le workflow, cliquez sur Modifier en haut à droite.
-
Sous « Filtres », sélectionnez le dépôt à partir duquel vous souhaitez ajouter des éléments.
-
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 récupérer toutes les demandes de tirage et tous les problèmes ouverts avec l’étiquette « question », utilisez
is:issue,pr label:question
. -
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.
- En haut à droite, cliquez sur pour ouvrir le menu.
- Dans le menu, cliquez sur Flux de travail.
- Sous Workflows par défaut, cliquez sur Élément ajouté au projet.
- À côté de Quand, vérifiez que
issues
etpull requests
sont sélectionnés. - À côté de Définir, sélectionnez État : À faire.
- Cliquez sur le bouton bascule Désactivé pour activer le workflow.
Pour plus d’informations sur l’automatisation de votre projet et d’autres flux de travail par défaut que vous pouvez configurer pour maintenir vos éléments de projet à jour, consultez Automatisation de votre project.
Affichage des graphiques et des informations
Vous pouvez utiliser les insights des Projects pour voir, créer et personnaliser des graphiques qui utilisent les éléments ajoutés à votre projet comme données sources. Vous pouvez appliquer des filtres au graphique par défaut et également créer vos propres graphiques en choisissant le regroupement, la disposition, la configuration des axes X et Y.
- Accédez à votre projet.
- En haut à droite, pour accéder aux insights, cliquez sur .
- Dans le menu de gauche, cliquez sur Nouveau graphique.
- Si vous le souhaitez, pour modifier le nom du nouveau graphique, cliquez sur , tapez un nouveau nom, puis appuyez sur Retour.
- Au-dessus du graphique, tapez des filtres pour modifier les données utilisées pour générer le graphique. Consultez Filtrage de projects.
- À droite de la zone de texte de filtre, cliquez sur Enregistrer les modifications.
Pour plus d’informations, consultez « À propos des insights des Projects ».