Решён
Как писать комментарии от имени сообщества в GitHub?

Anton Fullstack • Веб-разработка •
2.4k
4

Работаю в опенсорс проекте, где несколько мейнтейнеров. Иногда нужно отвечать на issue или pull request не от своего имени, а как бы от лица всей команды проекта.

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

Видел в некоторых больших проектах комментарии где написано типа "On behalf of the maintainers team...", но это выглядит громоздко.

GitGitHubOpen SourceКоллаборация

4 ответа

Лучшие Новые Старые
Решение
46
Участник • 1 ответ

В GitHub нет встроенного функционала для комментариев "от имени организации". Каждый комментарий всегда привязан к конкретному личному аккаунту.

Есть три распространенных подхода:

  1. Shared account - Создать отдельный аккаунт типа projectname-bot или projectname-team, дать доступ нескольким мейнтейнерам через общий пароль или SSH ключи. Минусы: нарушает ToS GitHub (один аккаунт = один человек), плюс проблемы с аудитом (непонятно кто конкретно написал).

  2. GitHub Actions bot - Настроить автоматизацию через Actions, которая постит комментарии от имени github-actions[bot]. Подходит для шаблонных ответов ("Thanks for contribution, we'll review soon"), но для живого общения не годится.

  3. Префикс в комментарии (рекомендуемый) - Каждый мейнтейнер пишет от своего имени, но начинает официальные комментарии с маркера:

    **[Maintainers decision]**
We've decided to...

Или в стиле Rust проекта:

@rfcbot fcp merge

Это сохраняет прозрачность (видно кто именно принял решение), но показывает что это не личное мнение а позиция команды.

Аватар Anton Fullstack
Anton Fullstack Автор

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

6
Участник • 1 ответ

Мы в нашем проекте завели отдельный аккаунт our-project-maintainers и логинимся через него когда нужно написать что то официальное. Пароль в общем секретном хранилище команды.

Да, технически это против правил GitHub, но за 3 года никто не банил. Главное не использовать этот аккаунт для коммитов (только для комментариев в issues).

23
Участник • 1 ответ

Можно настроить GitHub App которая будет постить комментарии. Создаешь приложение, даешь ему permissions на issues, и триггеришь через webhook или вручную.

Пример: https://docs.github.com/en/apps/creating-github-apps

Комменты будут выглядеть как от бота (с иконкой [bot]), но в описании приложения можно указать что это официальный голос команды.

31
Эксперт • 2 ответа

Зачем вообще скрывать кто именно из мейнтейнеров пишет? Это же опенсорс, тут прозрачность важна.

Если решение принято коллегиально - напиши "We (maintainers team) decided..." и все. Нет смысла городить ботов или фейковые аккаунты.

Написать ответ

Визуальный редактор (WYSIWYG)
Премодерация гостей

Вы отвечаете как гость. Ваш ответ будет скрыт до проверки модератором. Чтобы ответ появился сразу и вы получали репутацию — войдите в аккаунт.

Или войдите в систему
Будьте вежливы и соблюдайте правила платформы.