Введение
В этом руководстве показано, как использовать GitHub Issues для планирования и отслеживания элемента работы. В этом руководстве вы создадите новую проблему и добавите к ней список задач для отслеживания вложенных задач. Вы также узнаете, как добавлять метки, вехи, уполномоченных и проекты для обмена метаданными о проблеме.
Необходимые компоненты
Чтобы создать проблему, вам потребуется репозиторий. Вы можете использовать существующий репозиторий, к которому у вас есть доступ для записи, или создать репозиторий. Для репозитория должны быть включены проблемы. Дополнительные сведения о создании репозитория см. в разделе "Создание репозитория". Дополнительные сведения о включении проблем, если они отключены в репозитории, см. в разделе "Отключение проблем".
Открытие пустой проблемы
Сначала создайте проблему. Существует несколько способов создавать проблемы, и вы можете выбрать наиболее подходящий для вашего рабочего процесса. В этом примере будет использоваться пользовательский интерфейс GitHub. Дополнительные сведения о других способах создания проблемы см. в разделе "Создание проблемы".
-
На GitHubперейдите на главную страницу репозитория.
-
В поле имени репозитория щелкните Проблемы.
-
Щелкните Новая проблема.
-
В этом примере мы начнем с пустой проблемы. Репозиторий может использовать шаблоны проблем, которые помогают участникам предоставлять конкретные сведения. Если репозиторий использует шаблоны проблем, нажмите кнопку "Открыть пустую проблему".
Заполнение сведений
Присвойте вашей проблеме описательное название. Это название должно с первого взгляда дать общее понимание контекста.
Добавьте описание, которое объясняет назначение проблемы, и добавьте в него все сведения, которые могут помочь в устранении проблемы. Например, если вы оформляете отчет об ошибке, опишите шаги для воспроизведения ошибки, ожидаемый и фактический результаты.
Вы можете использовать разметку Markdown для форматирования, ссылок, смайликов и так далее. Дополнительные сведения см. в разделе «Создание документов на GitHub».
Добавление списка задач
Иногда удобно разбивать большие проблемы на мелкие задачи или отслеживать несколько однотипных проблем в одной более крупной проблеме. Добавьте в проблему список задач, снабжая каждый элемент списка префиксом [ ]
. Укажите ссылки по номерам или URL-адресам на другие существующие проблемы. Вы можете создать в формате обычного текста задачи, которые не сопоставляются с определенной проблемой, а позднее преобразовать их в проблемы. Дополнительные сведения см. в разделе «Сведения о списках задач».
Добавление меток
Добавьте метку для классификации проблемы. Например, можно использовать метку bug
и метку good first issue
, чтобы обозначить проблема как ошибку, за исправление которой может взяться новый участник. Пользователи могут фильтровать проблемы по меткам, чтобы получить все проблемы с определенной меткой.
Вы можете использовать стандартные метки или создать собственные. Дополнительные сведения см. в разделе «Управление метками».
Добавление вех
Вы можете добавить веху для отслеживания проблемы в рамках целевого объекта на основе дат. Веха отображает ход решения проблем по мере достижения целевой даты. Дополнительные сведения см. в разделе «Сведения о вехах».
Назначение проблемы
Чтобы обозначить зоны ответственности, вы можете назначить проблему определенному участнику в организации. Дополнительные сведения см. в разделе «Назначение проблем и запросов на вытягивание другим пользователям GitHub».
Добавление проблемы в проект
Вы можете добавить проблему в существующий проект и заполнить метаданные для проекта. Дополнительные сведения о проектах см. в статье "Сведения о Projects".
Отправка проблемы
Щелкните Отправить новую проблему, чтобы создать проблему. После создания проблемы можно изменить любое из описанных выше полей. У вашей проблемы есть уникальный URL-адрес, который можно передать другим участникам команды, указать в описании других проблем или запросов на вытягивание.
Взаимодействие
После создания проблемы продолжайте общение, добавляя комментарии к проблеме. Вы можете указать коллег или команды в @mention, чтобы привлечь их внимание к комментариям. Чтобы связать связанные проблемы в том же репозитории, можно ввести #
перед заголовком проблемы, а затем щелкнуть проблему, которую нужно связать. Дополнительные сведения см. в разделе «Создание документов на GitHub».
Следующие шаги
Проблемы можно использовать для широкого спектра задач. Например:
- Отслеживание идей
- Сбор отзывов
- Задачи по планированию
- Информирование об ошибках
Далее приведены некоторые полезные ресурсы для выполнения следующих этапов с помощью GitHub Issues.
- Дополнительные сведения о проблемах см. в разделе "О проблемах".
- Дополнительные сведения о том, как проекты помогут вам с планированием и отслеживанием, см. в статье "Сведения о Projects".
- Дополнительные сведения об использовании шаблонов проблем для поощрения участников предоставлять конкретные сведения см. в разделе "Использование шаблонов для описания важных проблем и выполнения запросов на вытягивание".