Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.

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

Включите GitHub Discussions в существующем репозитории или организации и начните беседы с сообществом.

Введение

GitHub Discussions — это форум для совместной работы участников сообщества над проектом с открытым кодом или внутренний проект. Обсуждения предназначены для бесед, которые должны быть прозрачными и доступными, но не должны отслеживаться на панели проекта и не связаны с кодом, в отличие от GitHub Issues. Обсуждения позволяют вести гибкую, открытую беседу на публичном форуме.

Обсуждения дают возможность для расширенной совместной работы в ходе беседы путем подключения и предоставления централизованной области для подключения и поиска информации.

Включение GitHub Discussions для репозитория

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

При первом включении GitHub Discussions вам будет предложено настроить приветственное сообщение.

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

  2. Нажмите Параметры под именем репозитория.

    Снимок экрана: вкладки в репозитории GitHub. Параметр "Параметры" выделен темно-оранжевым цветом.

  3. Прокрутите вниз до раздела "Функции" и щелкните Настройка обсуждений.

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

  4. В разделе "Начать новое обсуждение" измените шаблон, чтобы выровнять ресурсы и тональность, которую вы хотите задать для вашего сообщества.

  5. Нажмите кнопку Начать обсуждение.

Включение GitHub Discussions для организации

Владельцы организации могут включить GitHub Discussions для своей организации.

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

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

Исходный репозиторий можно изменить в любое время. При изменении исходного репозитория обсуждения не переносятся в новый исходный репозиторий.

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

  2. Под названием организации щелкните Параметры.

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

  3. В разделе "Обсуждения" выберите Включить обсуждения для этой организации.

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

  5. Выберите команду Сохранить.

Поощрение вкладов в ваши обсуждения

Можно поприветствовать сообщество и предложить новый способ взаимодействия в репозитории или организации, создав приветственное сообщение и закрепив запись на странице GitHub Discussions. Закрепление и блокировка обсуждений сообщает пользователям, что такая публикация выполняет роль объявления. Объявления можно использовать для предоставления пользователям дополнительных ресурсов и рекомендаций по открытию обсуждений в сообществе. Дополнительные сведения о закреплении обсуждения см. в разделе Управление обсуждениями.

Настройка правил сообщества для участников

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

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

Создание нового обсуждения

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

  1. На GitHub.com перейдите на главную страницу репозитория или организации, в которой вы хотите начать обсуждение.

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

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

  3. В правой части страницы щелкните Создать обсуждение.

  4. Выберите категорию обсуждения, нажав кнопку Начало работы.

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

  5. В разделе "Название обсуждения" введите название обсуждения, а в разделе "Написать" введите текст обсуждения.

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

  6. Нажмите кнопку Начать обсуждение.

Создание нового опроса

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

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

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

  2. В списке категорий выберите пункт Опросы.

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

  3. Справа щелкните Новое обсуждение.

  4. В разделе "Название обсуждения" введите заголовок и при необходимости в разделе "Запись" введите текст опроса.

    Снимок экрана: страница для запуска нового опроса.

  5. В разделе "Вопрос опроса" введите вопрос для опроса.

  6. В разделе "Параметры опроса" введите по крайней мере два параметра опроса.

  7. При необходимости, чтобы добавить дополнительный параметр опроса, щелкните Добавить параметр.

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

  8. Нажмите кнопку Начать опрос.

Организация обсуждений

Владельцы репозитория и пользователи с доступом для записи в репозиторий могут создавать новые категории для упорядочения обсуждений. Аналогичным образом поскольку обсуждения организации основаны на исходном репозитории, владельцы репозитория и пользователи с доступом для записи в исходный репозиторий могут создавать новые категории для обсуждений в организации.

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

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

Поощрение этичных и эффективных бесед

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

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

Дальнейшие действия

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