Skip to main content

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

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

Введение

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

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

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

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

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

  1. На GitHub.com перейдите на главную страницу репозитория.
  2. Нажмите Параметры под именем репозитория. Кнопка "Общедоступные параметры"
  3. В разделе "Компоненты" щелкните Настройка обсуждений. Настройка кнопки обсуждения в разделе "Компоненты" для включения или отключения GitHub Discussions для репозитория
  4. В разделе "Начать новое обсуждение" измените шаблон, чтобы выровнять ресурсы и тональность, которую вы хотите задать для вашего сообщества.
  5. Нажмите кнопку Начать обсуждение. Кнопка "Начать обсуждение"

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

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

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

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

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

  1. На GitHub.com перейдите на главную страницу организации.
  2. Под названием организации щелкните Параметры. Кнопка параметров организации
  3. В разделе "Обсуждения" выберите Включить обсуждения для этой организации.
  4. Выберите репозиторий, который будет использоваться в качестве источника для обсуждений в организации. Параметры включения обсуждений в организации
  5. Выберите команду Сохранить.

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

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

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

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

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

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

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

  1. На GitHub.com перейдите на главную страницу репозитория или организации, где вы хотите начать обсуждение.
  2. Под именем репозитория или организации нажмите на Обсуждения. Вкладка "Обсуждения" для репозитория
  3. Нажмите кнопку Новое обсуждение. Кнопка "Новое обсуждение" на вкладке "Обсуждения" для репозитория
  4. Выберите раскрывающееся меню Выбор категории и выберите категорию для обсуждения. Раскрывающееся меню "Выбор категории" и список доступных категорий в репозитории
  5. Введите заголовок и текст для обсуждения. Текстовые поля для заголовка и текста нового обсуждения
  6. Нажмите кнопку Start discussion (Начать обсуждение). Кнопка "Start discussion" (Начать обсуждение)

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

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

  1. На GitHub.com перейдите на главную страницу репозитория. 1. Под именем репозитория или организации нажмите на Обсуждения. Вкладка "Обсуждения" для репозитория
  2. В списке категорий выберите пункт Опросы. Снимок экрана: категория "Опрос"
  3. В правой области нажмите кнопку Начать опрос. Снимок экрана: кнопка "Начать опрос"
  4. Введите название и при необходимости текст опроса. Снимок экрана: текстовые поля для заголовка и текста
  5. Введите вопрос для опроса. Снимок экрана: текстовые поля для вопроса опроса
  6. Введите по крайней мере два варианта ответа для опроса. Снимок экрана: текстовые поля для вариантов ответа для опроса
  7. Если необходимо добавить другой вариант ответа, нажмите кнопку Добавить вариант ответа. Снимок экрана: кнопка "Добавить вариант ответа"
  8. Нажмите кнопку Начать опрос. Снимок экрана: кнопка "Начать опрос"

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

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

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

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

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

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

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

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

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