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