Создание шаблона запроса на вытягивание для репозитория

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

В этой статье

Дополнительные сведения см. в разделе Сведения о шаблонах проблем и запросов на вытягивание.

Можно создать подкаталог PULL_REQUEST_TEMPLATE/ в любой из поддерживаемых папок, чтобы он содержал шаблоны для нескольких запросов на вытягивание, и использовать параметр запроса template, чтобы указать шаблон, который будет заполнять текст запроса на вытягивание. Дополнительные сведения см. в разделе Использование параметров запроса для создания запроса на вытягивание.

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

Добавление шаблона запроса на вытягивание

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

  2. Над списком **** файлов выберите раскрывающееся меню , а затем щелкните Создать новый файл.

    Кроме того, можно щелкнуть в представлении дерева файлов слева.

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

  3. В поле имени файла:

    • Чтобы сделать шаблон запроса на вытягивание видимым в корневом каталоге репозитория, присвойте шаблону запроса на вытягивание имя pull_request_template.md.
    • Чтобы сделать шаблон запроса на вытягивание видимым в каталоге docs репозитория, присвойте шаблону запроса на вытягивание имя docs/pull_request_template.md.
    • Чтобы сохранить файл в скрытом каталоге, присвойте шаблону запроса на вытягивание имя .github/pull_request_template.md.
    • Чтобы создать шаблоны для нескольких запросов на вытягивание и использовать параметр запроса template, чтобы указать шаблон для заполнения текста проблемы, введите .github/PULL_REQUEST_TEMPLATE/, а затем имя шаблона запроса на вытягивание. Например: .github/PULL_REQUEST_TEMPLATE/pull_request_template.md. Можно также хранить шаблоны для нескольких запросов на вытягивание в подкаталоге PULL_REQUEST_TEMPLATE, в корне или каталогах docs/. Дополнительные сведения см. в разделе Использование параметров запроса для создания запроса на вытягивание.

  4. Добавьте шаблон запроса на вытягивание в текст нового файла. Этот шаблон может состоять из запроса включить:

    • ссылка на связанную проблему в репозитории;
    • описание изменений, предлагаемых в запросе на вытягивание;
    • @mentions пользователя или команды, ответственной за проверку предлагаемых изменений.

  5. Нажмите кнопку " Зафиксировать изменения" ...

  6. В поле "Фиксация сообщения" введите короткое понятное сообщение фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами.

  7. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений.

    Снимок экрана: запрос на вытягивание GitHub с переключателем для фиксации непосредственно в главной ветви или создания новой ветви. Выбрана новая ветвь.
    Шаблоны доступны участникам совместной работы при их слиянии в ветвь репозитория по умолчанию.

  8. Нажмите кнопку Зафиксировать изменения или Предложить изменения.

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