Предоставление общего доступа к концепции проекта, просмотр действий проекта

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Каждый проект предоставляет сводку или домашнюю страницу для обмена информацией и демонстрации последних действий проекта. Эта страница используется для выполнения одной или нескольких следующих задач.

задачи администратора Project

Project задачи-члены

  • Добавление краткого описания проекта
  • Выбор файла README или вики-сайта для сведений о проекте
  • Приглашение людей для участия в проекте
  • Установка тегов проекта
  • Выбор файла README или вики-сайта для сведений о проекте
  • Приглашение людей для участия в проекте
  • Просмотр сведений о проекте
  • Просмотр действий проекта
  • Избранное проекта
  • Отправка электронной почты или инициирование чата с участником команды
  • Запуск поиска в проекте
  • Просмотр сведений о проекте
  • Отправка электронной почты или инициирование чата с участником команды
  • Просмотр действий проекта

Примечание

Размещенные проекты можно назначить частными или общедоступными. Для общедоступных проектов анонимные пользователи могут просматривать сводку проекта, за исключением раздела "Участники ". Кроме того, значки "Нравится " и "Избранное " не видны анонимным пользователям. Дополнительные сведения об общедоступных проектах см. в статье "Что такое общедоступный проект"?

Screenshot of summary page.

Screenshot of summary page, TFS-2018.

Примечание

Если вы хотите использовать вики-сайт проекта для сведений сводки проекта, сначала создайте вики-сайт для проекта. Затем можно изменить страницу сводки проекта, чтобы она указывала на вики-сайт.

Предварительные условия

  • Вы должны быть членом группы администраторов Project или иметь разрешение на изменение сведений на уровне проекта, чтобы разрешить выполнять следующие действия:
    • Изменение сведений на странице проекта
    • Изменение репозитория, используемого для совместного использования сведений о проекте
    • Управление членством в проекте
  • Чтобы изменить страницу, вы должны быть участником репозитория или ветви или иметь разрешения на участие , для которых задано значение Allow.
  • Чтобы просмотреть сводку проекта, необходимо быть допустимым членом проекта. Дополнительные сведения см . в разделе "Безопасность", "Членство" и "Разрешения"; Допустимые группы пользователей.
  • Чтобы добавить или изменить теги проекта, необходимо иметь разрешение на управление свойствами на уровне проекта в значение Allow. Это разрешение управляет rest API свойств проекта. REST API свойств проекта используется для управления интерфейсом тегов проекта в продукте.

Совет

Если у вас нет разрешений на изменение страницы или использование функции, соответствующие значки и ссылки не отображаются.

Открытие сводки проекта

В веб-браузере выберите OverviewSummary>. Если у вас еще нет проекта, создайте проект.

Если вы еще не настроили сводку проекта, вы увидите эту страницу приветствия:

Open project summary, new nav

Чтобы приступить к работе, выберите одну из следующих задач:

Открытие домашней страницы проекта

В веб-браузере откройте раскрывающееся меню командного проекта и выберите домашнюю страницу. Если у вас нет проекта, создайте командный проект.

Open Project Summary

Сведения о том, как определить файл README для проекта, см. в статье " Инициализация файла README" для репозитория Git или инициализация файла README для репозитория TFVC.

Обновление страницы

На странице сводки отображается файл README , определенный в репозитории проекта, или домашняя страница вики-сайта проекта. Если вы хотите использовать домашнюю страницу проекта, сначала настройте ее, как описано в разделе "Создание вики-сайта для проекта".

  1. Чтобы изменить страницу, выполните следующие действия.

    • Если страница впервые редактируется, нажмите кнопку "Добавить Project описание".
      Screenshot of summary page, first time editing.

    • Если после настройки страницы измените ее, выберите "Изменить сведения о проекте". Этот значок виден только членам с разрешениями на изменение страницы сводки проекта.

  2. Введите краткое описание назначения проекта в поле "Описание ".

    About this project dialog.

  3. При необходимости добавьте один или несколько тегов для проекта. Эти теги похожи на теги рабочих элементов. Вы можете добавить несколько тегов за раз с помощью разделителей с запятыми или точками с запятой. Теги должны соответствовать следующим правилам:

    • Теги должны содержать 40 символов или меньше
    • Теги не могут содержать символ косой черты (/) или заканчиваться дефисом (-)
    • В проект можно добавить не более 15 тегов.
    • Теги не учитывают регистр и не допускаются повторяющиеся теги или пустые теги.

    Примечание

    Функции поиска и фильтрации нельзя использовать для поиска или фильтрации по тегам проекта.

  4. Укажите, следует ли ссылаться на файл README или домашнюю страницу проекта для остальной части содержимого страницы сводки.

    Совет

    Чтение по умолчанию создается в репозитории, добавленном при создании проекта. Вы можете выбрать этот файл README или создать другой репозиторий и файл README для этой цели.

    При выборе файла сведений выберите репозиторий для README. Отображается предварительный просмотр текущего текста для файла README.

    About this project dialog, choose and select README repository.

    При выборе вики-сайта обратите внимание, что ссылка на домашнюю страницу вики-сайта должна быть первым файлом в вики-toC. Вы не можете изменить эту ссылку.

  5. Чтобы обновить содержимое файла README или вики-файла, измените соответствующий файл. Дополнительные сведения см. в статье "Создание readME" для репозитория или "Добавление" и редактирование вики-страниц.

    Рассмотрите возможность включения следующих типов сведений на странице сводки :

    • Способы участия пользователей в проекте
    • Кто для связи с повышением разрешений или добавлением расширений
    • Сведения о стратегии
    • Ссылки на инструкции по настройке сред разработки и тестирования
    • Ссылки на инструкции по совместной работе с кодом, отслеживанием работы, сборкой конвейеров, развертыванием выпусков
    • Ссылки на шаблоны для отправки ошибок, проблем или запросов
    • Ссылки на списки рассылки по электронной почте или публикации вопроса на канале Slack или Teams.

Приглашение людей для участия в проекте

Вы можете отправить сообщение электронной почты, чтобы пригласить пользователей для участия в проекте, выбрав " Пригласить". Дополнительные сведения см. в статье "Добавление пользователей или групп в группу или проект", "Пригласить пользователей" на странице "Сводка".

Screenshot of Summary page, Invite button.

Чтобы добавить пользователей в проект, нажмите кнопку "Добавить ". Дополнительные сведения см. в статье "Добавление пользователей в командный проект или команду".

Screenshot of Summary page, Add members button.

Примечание

Для локального Azure DevOps все действия электронной почты требуют настройки SMTP-сервера.

Просмотр действий проекта

В разделе Project статистики или активности можно просмотреть обновления, внесенные в проект за последние 1, 7 или 30 дней. Выберите параметр представления, как показано на следующем рисунке.

Screenshot of Summary page, Stats section.

Screenshot of Summary page, Activity section, TFS-2018.

Электронная почта или чат с участником проекта

В разделе "Участники" вы увидите некоторые элементы, добавленные в проект, и подключитесь к ним по электронной почте или чату с участником.

Screenshot of Summary page, Members section.

Примечание

100+ означает, что в проект добавлено 100 или более участников.

Чтобы отправить сообщение электронной почты или инициировать сеанс чата, выберите участника команды и выберите нужный вариант.

Screenshot of Summary page, Members section, options available to connect to a team member.

Примечание

Для локального Azure DevOps все действия электронной почты требуют настройки SMTP-сервера.

На странице сводки можно инициировать поиск кода, рабочих элементов и вики-сайта. Дополнительные сведения см. в статье начало работы с помощью поиска. Screenshot of Summary page, search box.

Инициализация файла README для репозитория Git

Вы можете предоставить общий доступ к проекту и цели, а также способы участия участников группы в проекте с помощью файла README проекта. Для проектов Git файл README.md должен находиться в корне каждого репозитория в ветви по умолчанию. Для проектов на основе Git левая панель поддерживает навигацию по другим репозиториям. Для каждого репозитория можно создать отдельную страницу приветствия или файл README.md.

  1. Откройте файл Repos> Files. На этой странице вы можете быстро приступить к работе, добавив код в репозиторий при выборе одного из вариантов клонирования, отправки, импорта или инициализации репозитория.

  2. Установите флажок "Добавить readME" и нажмите кнопку "Инициализировать".

    Screenshot of Initialize README file, latest versions

    Файл README по умолчанию добавляется в репозиторий проектов, в данном случае репозиторий тестирования Fabrikam .

  3. Вернитесь в OverviewSummary> и выберите файл README для страницы проекта. Нажмите кнопку "Изменить".

    Choose README file, new nav

  4. Выберите репозиторий проекта, в котором инициализирован файл README.

    Choose Repository where the README file exists, new nav

  5. Чтобы изменить файл README, выберите ссылку на файл README.

    Edit the README file, new nav

    Вы будете перенаправлены на страницу Repos> Files для файла README. Вы можете изменить и изменить файл ReadME Markdown, как и любой другой файл в репозитории Git. Вы можете использовать язык Markdown для форматирования файла README и добавления изображений. Дополнительные сведения о добавлении файла README см. в статье "Создание readME" для репозитория и руководства по Markdown.

  1. Откройте домашнюю страницу Project.

  2. Установите флажок "Добавить readME" и нажмите кнопку "Инициализировать".

    Screenshot of Initialize README file, new nav

    Файл README по умолчанию добавляется в репозиторий проектов, в данном случае репозиторий тестирования Fabrikam .

  3. Чтобы изменить файл README.md проекта, нажмите кнопку "Изменить".

    Git new project summary page

    Используйте язык Markdown для форматирования файла README и добавления изображений. Дополнительные сведения о добавлении файла README см. в статье "Создание readME" для репозитория и руководства по Markdown.

Инициализация файла README для репозитория TFVC

Для проектов, которые выбрали TFVC для управления версиями, файл README.md должен находиться в корне папки командного проекта (например, $/TeamProject/README.md).

  1. Откройте файл Repos> Files.

  2. Выберите "Добавить Project описание".

    Welcome page, TFVC new project, create readme, new nav

  3. Выберите репозиторий TFVC и нажмите кнопку "Сохранить". Если файл README еще не создан в репозитории, появится следующее сообщение.

    About this project dialog, new nav

  4. Чтобы создать файл README, выберите Repos> Files и выберите новый файл, чтобы добавить файл в репозиторий проекта.

  5. Присвойте файлу имя README.md.

    Add new file dialog, new nav

  6. Добавьте содержимое файла README в формате Markdown и нажмите кнопку "Возврат...".

    Enter README file contents, new nav

  7. Нажмите кнопку "Вернуться ", чтобы завершить процесс возврата файла README.

    Check-in README file dialog, new nav

  8. Выберите OverviewSummary>, чтобы просмотреть страницу сводки проекта с отображаемым файлом README.

    Project summary page with the README file displayed.

  1. Откройте домашнюю страницу Project.

  2. Выберите "Создать README".

    Welcome page, TFVC new project, create README

    Файл README по умолчанию добавляется в репозиторий проектов, в данном случае репозиторий Fabrikam Fibre TFVC .

  3. Вы можете немедленно изменить файл README. Когда все будет готово, нажмите кнопку "Вернуть".

    Edit page, new nav
    Все дополнительные файлы Markdown ( с расширением *.md) в корневой папке проекта также отображаются в левой области для удобной навигации между ними, чтобы предоставить дополнительные сведения.

REST API;