Создание проблемы

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

Администраторы репозитория могут отключать проблемы для репозитория. Дополнительные сведения см. в разделе Отключение проблем.

Создание проблемы из репозитория

1. На экземпляр GitHub Enterprise Server перейдите на главную страницу репозитория. 1. Под именем репозитория щелкните Проблемы.

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

2. Если в репозитории используются шаблоны проблем, рядом с типом проблемы, которую вы хотите открыть, нажмите кнопку Начало работы.

   Если тип проблемы, который вы хотите открыть, не включен в доступные параметры, нажмите кнопку Открыть пустую проблему.

   

3. В поле "Название" введите название проблемы.

4. В поле текста комментария введите описание проблемы. 1. Если вы являетесь координатором проекта, вы можете назначить проблему другому пользователю, добавить ее на панель проекта, связать ее с вехой или применить метку. 1. Закончив, нажмите кнопку Отправить новую проблему.

Создание проблемы с помощью GitHub CLI

GitHub CLI — это инструмент с открытым исходным кодом для использования GitHub из командной строки компьютера. При работе с командной строкой можно использовать GitHub CLI — это позволит экономить время и не переключать контекст. Дополнительные сведения о GitHub CLI см. в разделе Сведения о GitHub CLI.

Чтобы создать проблему, используйте подкоманду gh issue create. Чтобы пропустить интерактивные подсказки, включите флаги --body и --title.

gh issue create --title "My new issue" --body "Here are more details."

Также можно указать уполномоченных пользователей, метки, вехи и проекты.

gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"

Создание проблемы из комментария

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

1. Перейдите к комментарию, из которого хотите создать проблему.

2. В этом комментарии щелкните .

   

3. Щелкните Создать ссылку в новой проблеме.

4. Используйте раскрывающееся меню "Репозиторий" и выберите репозиторий, в который вы хотите открыть проблему.

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

6. Щелкните Создать проблему.

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

Создание проблемы из кода

Новую проблему можно создать из конкретной строки или нескольких строк кода в файле или запросе на вытягивание. При создании проблемы из кода она будет содержать фрагмент, отображающий выбранную строку или диапазон кода. Создать такую проблему можно только в том репозитории, в котором хранится код.

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

2. Найдите код, на который хотите сослаться в проблеме:

   • Чтобы создать проблему по коду из файла, откройте этот файл.
   • Чтобы открыть проблему с кодом в запросе на вытягивание, перейдите к запросу на вытягивание и щелкните Файлы изменены. Затем откройте файл, содержащий код, который необходимо включить в комментарий, и щелкните Просмотреть.

3. Выберите, следует ли выбрать одну строку или диапазон.

   • Для выбора одной строки кода, щелкните номер строки, чтобы выделить ее.
   • Для выбора диапазона щелкните номер первой строки диапазона, чтобы выделить ее. Затем наведите указатель мыши на последнюю строку диапазона кода, нажмите клавишу SHIFT и щелкните номер строки, чтобы выбрать весь диапазон.

4. Слева от диапазона кода щелкните . В раскрывающемся меню щелкните Ссылка в новой проблеме.

   

5. В поле "Название" введите название проблемы.

6. В поле текста комментария введите описание проблемы. 1. Если вы являетесь координатором проекта, вы можете назначить проблему другому пользователю, добавить ее на панель проекта, связать ее с вехой или применить метку. 1. Закончив, нажмите кнопку Отправить новую проблему.

Создание проблемы из обсуждения

Пользователи с разрешением на рассмотрение в репозитории могут создавать проблемы из обсуждений.

При создании проблемы из обсуждения содержимое записи обсуждения будет автоматически включено в текст проблемы с сохранением меток. Создание проблемы из обсуждения не преобразует обсуждение в проблему и не удаляет его. Дополнительные сведения о GitHub Discussions см. в разделе Сведения об обсуждениях.

1. Под именем репозитория или организации щелкните Обсуждения.

   1. В списке обсуждений щелкните обсуждение, которое нужно просмотреть.

2. На правой боковой панели щелкните Создать проблему из обсуждения.

   

3. В поле "Название" введите название проблемы.

4. В поле текста комментария введите описание проблемы. 1. Если вы являетесь координатором проекта, вы можете назначить проблему другому пользователю, добавить ее на панель проекта, связать ее с вехой или применить метку. 1. Закончив, нажмите кнопку Отправить новую проблему.

Создание проблемы из заметки доска проекта

Если вы используете доска проекта для отслеживания и определения приоритетов работы, вы можете преобразовать заметки в проблемы. Дополнительные сведения см. в разделах Сведения о project boards и Добавление заметок в project board.

Создание проблемы из запроса URL-адреса

Для создания проблем можно использовать параметры запроса. Параметры запроса — это необязательные части URL-адреса, которые можно настроить для совместного использования определенного представления веб-страницы, например результатов поиска с фильтрами или шаблона проблемы на GitHub. Чтобы создать собственные параметры запроса, необходимо сопоставить пару ключа и значения.

Чтобы использовать эквивалентный параметр запроса, необходимо иметь соответствующие разрешения для любого действия. Например, потребуется разрешение, чтобы добавить метку в проблему для использования параметра запроса labels. Дополнительные сведения см. в разделе Роли репозиториев для организации.

Если вы создадите недопустимый URL-адрес, используя параметры запроса, или если у вас нет соответствующих разрешений, URL-адрес вернет страницу ошибки 404 Not Found. Если вы создаете URL-адрес, превышающий ограничения сервера, он вернет страницу ошибки 414 URI Too Long.

Параметр запроса	Пример
title	https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report создает проблему с меткой "ошибка" и названием "Новый отчет об ошибках".
body	https://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. создает проблему с названием "Новый отчет об ошибках" и комментарием "Описание проблемы" в тексте проблемы.
labels	https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug создает проблему с метками "нужна помощь" и "ошибка".
milestone	https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones создает проблему с вехой "Тестирование вех".
assignees	https://github.com/octo-org/octo-repo/issues/new?assignees=octocat создает проблему и назначает ее пользователю @octocat.
projects	https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 создает проблему с названием "Исправление ошибок" и добавляет ее на доску проекта организации 1.
template	https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md создает проблему с шаблоном в тексте проблемы. Параметр запроса template поддерживает шаблоны, хранящиеся в корневом подкаталоге ISSUE_TEMPLATE, а также в каталогах docs/ и .github/ в репозитории. Дополнительные сведения см. в разделе Использование шаблонов для описания важных проблем и выполнения запросов на вытягивание.

Дополнительные материалы

• "Создание документов на GitHub"