Afficher et mettre à jour la page récapitulative du projet

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Chaque projet fournit un récapitulatif ou une page d’accueil pour partager des informations et présenter les dernières activités liées au projet. Cette page sert de hub central permettant aux les membres de l’équipe de s’informer sur l’avancement du projet. Utilisez cette page pour les tâches suivantes :

• Partager les nouveautés et annonces importantes relatives au projet
• Mettre en évidence les activités et les étapes récentes
• Fournir un accès rapide aux ressources et à la documentation clés du projet
• Faciliter la communication et la collaboration d’équipe

Utilisez la page récapitulative du projet pour effectuer également des tâches plus spécifiques :

Prerequisites

Ouvrir le résumé du projet

Dans votre navigateur web, sélectionnez Vue d’ensemble>Résumé. Si vous n’avez pas encore de projet, créez-en un.

Si le résumé de votre projet n’est pas encore configuré, une page d’accueil s’affiche :

Sélectionnez l’une des tâches suivantes pour commencer :

• Inviter pour commencer à ajouter d’autres personnes à votre projet. Vous ne pouvez inviter que les utilisateurs qui sont ajoutés à votre organisation.
• Tableaux pour commencer à ajouter des éléments de travail.
• Référentiels pour ouvrir la page Repos>Fichiers sur laquelle vous pouvez cloner ou importer un référentiel, ou initialiser un fichier README pour la page récapitulative de votre projet.
• Pipelines pour commencer à définir un pipeline.
• Plans de test pour commencer à définir des plans de test et des suites de test.
• Gérez vos services pour désactiver la visibilité d’un ou plusieurs services.

Mettre à jour la page récapitulative

La page récapitulative affiche le fichier README défini dans un référentiel de projet ou la page d’accueil d’un Wiki de projet. Pour utiliser la page d’accueil du wiki du projet, créez un wiki pour votre projet, puis vous pourrez modifier la page récapitulative du projet pour qu’elle pointe vers le wiki.

1. Modifiez la page :

   • S’il s’agit de la première modification de la page, sélectionnez Ajouter une description de projet.
     

   • Si ce n’est pas votre première modification de la page, sélectionnez Modifier les informations du projet. Seuls les membres disposant des autorisations nécessaires pour modifier la page Résumé du projet peuvent voir cette icône.

2. Fournissez une brève description de l’objectif du projet dans la zone Description.

   

3. (Facultatif) Ajoutez une ou plusieurs balises pour votre projet. Ces balises sont similaires aux balises d’élément de travail. Vous pouvez ajouter plusieurs balises à la fois à l’aide des délimiteurs de virgule ou de point-virgule. Les balises doivent être conformes aux règles suivantes :

   • Les balises doivent avoir 40 caractères au maximum
   • Les balises ne peuvent pas contenir le caractère de barre oblique (/) ou se terminer avec un trait d’union (-)
   • Au maximum 15 balises peuvent être ajoutées à un projet
   • Les balises sont insensibles à la casse, et aucune balise en double ni balise vide n’est autorisée.

   Note

   Les fonctions de recherche et de filtre ne peuvent pas être utilisées pour rechercher ou filtrer des balises de projet.

4. Choisissez de référencer un fichier README ou la page d’accueil du wiki du projet pour le reste du contenu de la page Résumé.

   Conseil

   Un fichier README par défaut est créé dans le référentiel ajouté lors de la création du projet. Vous pouvez choisir ce fichier README ou créer un autre référentiel et fichier README à cet effet.

   Si vous choisissez un fichier Readme, sélectionnez le référentiel du README. Un aperçu du texte actuel du fichier README s’affiche.

   

   Si vous choisissez un Wiki, la page d’accueil du Wiki est référencée et doit être le premier fichier dans la table des matières wiki. Vous ne pouvez pas modifier cette référence.

5. Pour mettre à jour le contenu du fichier README ou du wiki référencé, modifiez le fichier correspondant. Pour plus d’informations, consultez Créer un fichier README pour votre référentiel ou Ajouter et modifier des pages wiki.

   Envisagez d’inclure les types d’informations suivants sur la page Résumé :

   • Façons dont les utilisateurs peuvent contribuer à votre projet
   • Personnes à contacter pour élever des autorisations ou ajouter des extensions
   • Informations sur la feuille de route
   • Liens vers des instructions de configuration des environnements de développement et de test
   • Liens vers des instructions de collaboration sur le code, de suivi du travail, de création de pipelines, de déploiement de versions
   • Liens vers des modèles de soumission d’un bogue, d’un problème ou d’une demande
   • Liens vers des listes de distribution pour envoyer par e-mail une question ou publier une question sur le canal Slack ou Teams

Inviter des contributeurs à votre projet

Choisissez Inviter pour envoyer un e-mail invitant les utilisateurs à contribuer à votre projet. Pour plus d’informations, consultez Ajouter des utilisateurs ou des groupes à une équipe ou un projet, Inviter des utilisateurs à partir de la page récapitulative.

Afficher l’activité du projet

Dans la section Statistiques de projet ou Activité, vous pouvez consulter les mises à jour apportées au projet au cours des 1, 7 ou 30 derniers jours. Choisissez l’option Afficher, comme illustré dans l’image suivante.

Converser avec un membre du projet ou lui envoyer un e-mail

Dans la section Membres, vous pouvez voir certains des membres ajoutés au projet et entrer en contact avec eux par e-mail ou par chat.

Pour envoyer un e-mail ou lancer une session de chat, choisissez le membre de l’équipe affiché et sélectionnez l’option de votre choix.

Effectuer une recherche dans un projet

À partir de la page Résumé, vous pouvez lancer une recherche de votre code, de vos éléments de travail et de votre wiki. Pour plus d’informations, consultez Bien démarrer avec la recherche.

Initialiser un fichier README pour un dépôt Git

Vous pouvez partager votre projet et votre objectif, ainsi que les méthodes permettant aux membres de l’équipe de contribuer au projet via un fichier README de projet. Pour les projets Git, le fichier README.md doit être à la racine de chaque dépôt dans la branche par défaut. Pour les projets Git, le volet gauche prend en charge la navigation vers d’autres dépôts. Une page d’accueil ou un fichier README.md distinct peut être créé pour chaque dépôt.

1. Ouvrez Repos>Fichiers. Cette page vous explique comment faire vos premiers pas rapidement en ajoutant du code à votre dépôt lorsque vous choisissez l’une des options permettant de cloner, d’envoyer, d’importer ou d’initialiser un dépôt.

2. Une fois la case Ajouter un fichier README cochée, sélectionnez Initialiser.

   

   Un fichier README par défaut est ajouté au dépôt du projet, dans ce cas, Fabrikam Test.

3. Revenez à Vue d’ensemble>Résumé et choisissez le fichier README correspondant à la page du projet. Sélectionnez Modifier.

   

4. Sélectionnez le dépôt de projet dans lequel vous avez initialisé le fichier README.

   

5. Pour modifier le fichier README, choisissez le lien du fichier README.

   

   Vous êtes dirigé vers la page Repos>Fichiers correspondant au fichier README. Vous pouvez modifier le fichier README Markdown comme vous le feriez dans un dépôt Git. Vous pouvez utiliser le langage Markdown pour mettre en forme le fichier README et ajouter des images. Pour plus d’informations, consultez Créer un fichier README pour votre dépôt et Aide sur Markdown.

Initialiser un fichier README pour un référentiel TFVC

Pour les projets qui ont sélectionné TFVC pour le contrôle de version, le fichier README.md doit être à la racine du dossier de votre projet d’équipe, par exemple $/TeamProject/README.md.

1. Ouvrez Repos>Fichiers.

2. Sélectionnez Ajouter une description de projet.

   

3. Sélectionnez le référentiel TFVC, puis choisissez Enregistrer. Si aucun fichier README n’est dans le référentiel, le message suivant s’affiche.

   

4. Pour créer un fichier README, choisissez Repos>Fichiers et choisissez Nouveau fichier pour ajouter un fichier au référentiel du projet.

5. Nommez le fichier README.md.

   

6. Ajoutez le contenu du fichier README au format Markdown, puis choisissez Archiver...

   

7. Sélectionnez Archiver pour terminer le processus d’archivage du fichier README.

   

8. Sélectionnez Vue d’ensemble>Résumé pour passer en revue la page récapitulative de votre projet avec le fichier README affiché.

   

Contenu connexe

• En savoir plus sur les Wikis, les fichiers README et Markdown
• Démarrer en tant qu’administrateur
• Naviguez dans le portail Web
• Fonctionnalités et services inclus avec Azure DevOps

API REST

• Obtenir les propriétés du projet
• Définir les propriétés du projet