Commenting on an issue when a label is added

Например, если к проблеме добавлена метка help-wanted, можно добавить комментарий, чтобы пригласить участников к работе над проблемой.

В этом руководстве вы сначала создадите файл рабочего процесса, использующий действие peter-evans/create-or-update-comment.

Затем вы настроите рабочий процесс в соответствии с вашими потребностями. Создание рабочего процесса

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

Скопируйте следующее содержимое YAML в файл рабочего процесса.

1. Настройте параметры в файле рабочего процесса.

2. Замените help-wanted в if: github.event.label.name == 'help-wanted' меткой, в соответствии с которой требуется выполнять определенное действие.

3. Если вы хотите работать в соответствии с несколькими метками, разделите условия с помощью ||.

   YAML

   # Этот рабочий процесс использует действия, которые не сертифицированы GitHub.
   # Они предоставляются сторонним поставщиком, и на них распространяются
   # отдельные условия обслуживания, политика конфиденциальности и поддержка
   # документации.
   
   # GitHub рекомендует закрепить действия в фиксации SHA.
   # Чтобы получить более новую версию, потребуется обновить SHA.
   # Вы также можете ссылаться на тег или ветвь, однако действие может измениться без предупреждения.
   
   name: Add comment
   on:
     issues:
       types:
         - labeled
   jobs:
     add-comment:
       if: github.event.label.name == 'help-wanted'
       runs-on: ubuntu-latest
       permissions:
         issues: write
       steps:
         - name: Add comment
           uses: peter-evans/create-or-update-comment@a35cf36e5301d70b76f316e867e7788a55a31dae
           with:
             issue-number: ${{ github.event.issue.number }}
             body: |
               This issue is available for anyone to work on. **Make sure to reference this issue in your pull request.** :sparkles: Thank you for your contribution! :sparkles:

4. Например, if: github.event.label.name == 'bug' || github.event.label.name == 'fix me' будет добавлять комментарий при каждом добавлении меток bug или fix me к проблеме.

   • Измените значение body на комментарий, который нужно добавить. Поддерживается GitHub Flavored Markdown. Дополнительные сведения о Markdown см. в разделе Базовый синтаксис записи и форматирования.
   • Зафиксируйте файл рабочего процесса в ветви по умолчанию вашего репозитория. Дополнительные сведения см. в разделе Создание новых файлов. Тестирование рабочего процесса Этот рабочий процесс будет выполняться при каждом добавлении метки к проблеме в репозитории.

5. Если добавленная метка является одной из указанных в файле рабочего процесса, действие peter-evans/create-or-update-comment добавит к проблеме указанный комментарий.

Протестируйте рабочий процесс, применив указанную метку к проблеме.

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

Добавьте к проблеме указанную метку в файле рабочего процесса.

1. Дополнительные сведения см. в разделе Управление метками. Чтобы просмотреть выполнение рабочего процесса, которое было активировано путем применения метки к проблеме, просмотрите журнал выполнений рабочего процесса.
2. Дополнительные сведения см. в разделе Просмотр истории выполнения рабочего процесса. Когда рабочий процесс завершится, к помеченной проблеме должен быть добавлен комментарий.
3. Дальнейшие действия Дополнительные сведения о задачах, которые можно выполнить с помощью действия peter-evans/create-or-update-comment, например добавление реакций, см. в документации по действию peter-evans/create-or-update-comment.
4. When the workflow completes, the issue that you labeled should have a comment added.

Next steps

• To learn more about additional things you can do with the peter-evans/create-or-update-comment action, like adding reactions, visit the peter-evans/create-or-update-comment action documentation.