Введение
GitHub Discussions — это форум для совместной работы участников сообщества над проектом с открытым кодом или внутренний проект. Обсуждения предназначены для бесед, которые должны быть прозрачными и доступными, но не должны отслеживаться на панели проекта и не связаны с кодом, в отличие от GitHub Issues. Обсуждения позволяют вести гибкую, открытую беседу на публичном форуме.
Обсуждения дают возможность для расширенной совместной работы в ходе беседы путем подключения и предоставления централизованной области для подключения и поиска информации.
Включение GitHub Discussions для репозитория
Владельцы репозитория и пользователи с доступом на запись могут включить GitHub Discussions для сообщества в общедоступных, внутренних и частных репозиториях. Настройки видимости обсуждения наследуются от репозитория, в котором создается обсуждение.
При первом включении GitHub Discussions вам будет предложено настроить приветственное сообщение.
-
На экземпляр GitHub Enterprise Server перейдите на главную страницу репозитория.
-
Нажмите Параметры под именем репозитория.
-
Прокрутите вниз до раздела "Функции" и щелкните Настройка обсуждений.
-
В разделе "Начать новое обсуждение" измените шаблон, чтобы выровнять ресурсы и тональность, которую вы хотите задать для вашего сообщества.
-
Нажмите кнопку Начать обсуждение.
Включение GitHub Discussions для организации
Владельцы организации могут включить GitHub Discussions для своей организации.
При включении обсуждений в организации необходимо выбрать исходный репозиторий для обсуждений в организации. Можно использовать существующий репозиторий или создать репозиторий специально для проведения обсуждений в организации. Обсуждения будут отображаться как на странице обсуждений организации, так и на странице обсуждения исходного репозитория.
Разрешение на участие в обсуждении или управление им в организации основано на разрешениях в исходном репозитории. Например, пользователю требуется разрешение на запись в исходный репозиторий, чтобы удалять обсуждения организации. Это аналогично тому, как пользователю требуется разрешение на запись в репозитории для удаления обсуждения репозитория.
Исходный репозиторий можно изменить в любое время. При изменении исходного репозитория обсуждения не переносятся в новый исходный репозиторий.
-
На экземпляр GitHub Enterprise Server перейдите на главную страницу организации.
-
Под названием организации щелкните Параметры.
-
В разделе "Обсуждения" выберите Включить обсуждения для этой организации.
-
Используйте раскрывающееся меню, чтобы выбрать репозиторий, который будет использоваться в качестве исходного репозитория для обсуждений в организации.
-
Выберите команду Сохранить.
Поощрение вкладов в ваши обсуждения
Можно поприветствовать сообщество и предложить новый способ взаимодействия в репозитории или организации, создав приветственное сообщение и закрепив запись на странице GitHub Discussions. Закрепление и блокировка обсуждений сообщает пользователям, что такая публикация выполняет роль объявления. Объявления можно использовать для предоставления пользователям дополнительных ресурсов и рекомендаций по открытию обсуждений в сообществе. Дополнительные сведения о закреплении обсуждения см. в разделе Управление обсуждениями.
Настройка правил сообщества для участников
Для обсуждений в репозитории можно задать правила участия, чтобы побудить участников совместной работы вести значимые и полезные беседы по репозиторию. Вы также можете обновить файл сведений о репозитории, чтобы поделиться своими ожиданиями относительно того, когда участники совместной работы должны открывать проблему или обсуждение. Дополнительные сведения о предоставлении рекомендаций для проекта см. в разделах "Настройка проекта для внесения действенных вкладов".
Для обсуждений в организации можно поделиться информацией о способах взаимодействия с организацией, создав файл README для профиля организации. Дополнительные сведения см. в разделе Настройка профиля вашей организации.
Создание нового обсуждения
Все пользователи, прошедшие проверку подлинности, которые могут просматривать репозиторий, могут создавать обсуждение в репозитории. Аналогичным образом так как обсуждения организации основаны на исходном репозитории, любой прошедший проверку подлинности пользователь, который может просматривать исходный репозиторий, может создать обсуждение в этой организации.
-
На экземпляр GitHub Enterprise Server перейдите на главную страницу репозитория или организации, в которой вы хотите начать обсуждение.
-
Под именем репозитория или организации щелкните Обсуждения.
-
В правой части страницы щелкните Создать обсуждение.
-
Выберите категорию обсуждения, нажав кнопку Начало работы.
-
В разделе "Название обсуждения" введите название обсуждения, а в разделе "Написать" введите текст обсуждения.
-
Нажмите кнопку Начать обсуждение.
Создание нового опроса
Все пользователи, прошедшие проверку подлинности, которые могут просматривать репозиторий, могут создавать опрос. Аналогичным образом поскольку обсуждения организации основаны на исходном репозитории, любой прошедший проверку подлинности пользователь, который может просматривать исходный репозиторий, может создать опрос в этой организации.
-
На экземпляр GitHub Enterprise Server перейдите на главную страницу репозитория. 1. Под именем репозитория или организации щелкните Обсуждения.
-
В списке категорий выберите пункт Опросы.
-
Справа щелкните Новое обсуждение.
-
В разделе "Название обсуждения" введите заголовок и при необходимости в разделе "Запись" введите текст опроса.
-
В разделе "Вопрос опроса" введите вопрос для опроса.
-
В разделе "Параметры опроса" введите по крайней мере два параметра опроса.
-
При необходимости, чтобы добавить дополнительный параметр опроса, щелкните Добавить параметр.
-
Нажмите кнопку Начать опрос.
Организация обсуждений
Владельцы репозитория и пользователи с доступом для записи в репозиторий могут создавать новые категории для упорядочения обсуждений. Аналогичным образом поскольку обсуждения организации основаны на исходном репозитории, владельцы репозитория и пользователи с доступом для записи в исходный репозиторий могут создавать новые категории для обсуждений в организации.
Участники совместной работы, которые принимают участие в создании новых обсуждений, могут группировать обсуждения в наиболее подходящие существующие категории. Категории обсуждений можно изменить после их создания. Дополнительные сведения см. в разделе Управление категориями для обсуждений.
Чтобы более детально упорядочивать обсуждения, можно применять метки. Например, с помощью меток можно указать состояние обсуждения, чтобы повысить эффективность рассмотрения. У каждого репозитория есть один общий набор меток для проблем, запросов на вытягивание и обсуждений. Дополнительные сведения см. в разделе Управление метками.
Поощрение этичных и эффективных бесед
Пользователи с разрешениями на запись для репозитория или для исходного репозитория для обсуждений в организации могут помочь находить важные беседы, закрепляя обсуждения или удаляя те, которые больше не несут пользы или вредят сообществу, а также перенося обсуждения в более подходящие репозитории, принадлежащие организации. Дополнительные сведения см. в разделе Управление обсуждениями.
Пользователи с разрешениями на рассмотрение для репозитория или для исходного репозитория для обсуждений в организации могут помочь модерировать обсуждения по проекту, помечая комментарии как ответы, блокируя обсуждения, которые уже не являются полезными или наносят ущерб сообществу, и преобразовывать вопросы в обсуждения, если идея все еще находится на ранних этапах разработки. Дополнительные сведения см. в разделе Модерация обсуждений.
Дальнейшие действия
После того как вы найдете способ расширить область работы и довести идею до практического воплощения, можно создать проблему и начать отслеживание прогресса. Дополнительные сведения о создании проблемы из обсуждения см. в разделе Модерация обсуждений.