Skip to main content

Краткое руководство по GitHub Issues

Следуйте этому краткому интерактивному руководству, чтобы узнать о GitHub Issues.

Введение

В этом руководстве показано, как использовать GitHub Issues для планирования и отслеживания элемента работы. В этом руководстве вы создадите новую проблему и добавите к ней список задач для отслеживания вложенных задач. Вы также узнаете, как добавлять метки, вехи, уполномоченных и проекты для обмена метаданными о проблеме.

Необходимые компоненты

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

Открытие пустой проблемы

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

  1. На GitHubперейдите на главную страницу репозитория.

  2. В поле имени репозитория щелкните Проблемы.

    Снимок экрана: главная страница репозитория. На горизонтальной панели навигации вкладка с меткой "Проблемы" выделена темно-оранжевым цветом.

  3. Щелкните Новая проблема.

  4. В этом примере мы начнем с пустой проблемы. Репозиторий может использовать шаблоны проблем и формы проблем, которые помогают участникам предоставлять конкретные сведения. Если репозиторий использует шаблоны проблем, нажмите кнопку "Открыть пустую проблему".

Заполнение сведений

Присвойте вашей проблеме описательное название. Это название должно с первого взгляда дать общее понимание контекста.

Добавьте описание, которое объясняет назначение проблемы, и добавьте в него все сведения, которые могут помочь в устранении проблемы. Например, если вы оформляете отчет об ошибке, опишите шаги для воспроизведения ошибки, ожидаемый и фактический результаты.

Вы можете использовать разметку Markdown для форматирования, ссылок, смайликов и так далее. Дополнительные сведения см. в разделе Создание документов на GitHub.

Снимок экрана: новая форма проблемы с заполненным заголовком и текстом.

Добавление списка задач

Иногда удобно разбивать большие проблемы на мелкие задачи или отслеживать несколько однотипных проблем в одной более крупной проблеме. Добавьте в проблему список задач, снабжая каждый элемент списка префиксом [ ]. Укажите ссылки по номерам или URL-адресам на другие существующие проблемы. Вы можете создать в формате обычного текста задачи, которые не сопоставляются с определенной проблемой, а позднее преобразовать их в проблемы. Дополнительные сведения см. в разделе Сведения о списках задач.

Снимок экрана: новая форма проблемы с заполненным заголовком и текстом. Текст содержит Markdown для списка задач.

Добавление меток

Добавьте метку для классификации проблемы. Например, можно использовать метку bug и метку good first issue, чтобы обозначить проблема как ошибку, за исправление которой может взяться новый участник. Пользователи могут фильтровать проблемы по меткам, чтобы получить все проблемы с определенной меткой.

Вы можете использовать стандартные метки или создать собственные. Дополнительные сведения см. в разделе Управление метками.

Снимок экрана: новая форма проблемы. В правой боковой панели раздел "Метки" описан в темно-оранжевый цвет.

Добавление вех

Вы можете добавить веху для отслеживания проблемы в рамках целевого объекта на основе дат. Веха отображает ход решения проблем по мере достижения целевой даты. Дополнительные сведения см. в разделе Сведения о вехах.

Снимок экрана: новая форма проблемы. В правой боковой панели раздел "Веха" описан в темно-оранжевый цвет.

Назначение проблемы

Чтобы обозначить зоны ответственности, вы можете назначить проблему определенному участнику в организации. Дополнительные сведения см. в разделе Назначение проблем и запросов на вытягивание другим пользователям GitHub.

Снимок экрана: новая форма проблемы. В правой боковой панели раздел "Назначаемы" описан в темно-оранжевый.

Добавление проблемы в проект

Вы можете добавить проблему в существующий проект и заполнить метаданные для проекта. Дополнительные сведения о проектах см. в статье "Сведения о Projects".

Снимок экрана: новая форма проблемы. В правой боковой панели раздел "Проекты" описан в темно-оранжевый цвет.

Отправка проблемы

Щелкните Отправить новую проблему, чтобы создать проблему. После создания проблемы можно изменить любое из описанных выше полей. У вашей проблемы есть уникальный URL-адрес, который можно передать другим участникам команды, указать в описании других проблем или запросов на вытягивание.

Взаимодействие

После создания проблемы продолжайте общение, добавляя комментарии к проблеме. Вы можете указать коллег или команды в @mention, чтобы привлечь их внимание к комментариям. Чтобы связать связанные проблемы в том же репозитории, можно ввести # перед заголовком проблемы, а затем щелкнуть проблему, которую нужно связать. Дополнительные сведения см. в разделе Создание документов на GitHub.

Снимок экрана: комментарий о проблеме. Заголовок говорит "октокат комментировал сейчас", и тело говорит: "@hubot Нам также нужно обновить логику ракеты?"

Следующие шаги

Проблемы можно использовать для широкого спектра задач. Например:

  • Отслеживание идей
  • Сбор отзывов
  • Задачи по планированию
  • Информирование об ошибках

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

Далее приведены некоторые полезные ресурсы для выполнения следующих этапов с помощью GitHub Issues.