GitHub — это платформа для совместной работы

Завершено

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

В этом уроке мы узнаем о проблемах и обсуждениях. Это функции, которые способствуют совместной работе платформы GitHub Enterprise.

Проблемы

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

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

• Элемент в списке задач.
• Заметка в проекте.
• Комментарий в запросе на выдачу или вытягивание.
• Определенная строка кода.
• ЗАПРОС URL-адреса.

Создание проблемы из репозитория

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

2. В поле имени репозитория выберите "Проблемы".

   

3. Выберите новую проблему.

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

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

   Если репозиторий использует формы проблем, вы увидите структурированную форму для заполнения вместо пустого шаблона проблемы. Формы проблем позволяют обслуживателям собирать определенные сведения в стандартизованном формате.

   

5. В поле "Добавление заголовка" введите название проблемы.

6. В поле "Добавление описания" введите описание проблемы.

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

8. По завершении нажмите кнопку "Отправить новую проблему".

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

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

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

Обсуждения

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

Из этого раздела вы узнаете следующее:

• Включение обсуждения в репозитории.
• Создание нового обсуждения и различных категорий обсуждений.

Давайте рассмотрим включение обсуждения в репозитории.

Включение обсуждения в репозитории

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

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

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

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

   

3. Прокрутите вниз до раздела "Компоненты " и в разделе "Обсуждения" выберите пункт "Настройка обсуждений".

   

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

5. Выберите " Начать обсуждение".

Теперь вы готовы создать новое обсуждение.

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

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

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

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

   

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

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

   

Каждая категория обсуждения включает уникальное имя, эмодзи и описание для уточнения его цели. Службы поддержки категорий упорядочивают отправку бесед. Они настраиваются для различающихся категорий, которые являются беседами С&A или более открытыми беседами. В следующей таблице показаны категории по умолчанию для обсуждений и их назначение.

Категория	Целевые назначения	Формат
📣 Объявления	Обновления и новости от разработчиков проекта	Объявление
#️⃣ Общее	Все, что имеет отношение к проекту	Открытое обсуждение
💡 Идеи	Идеи по изменению или улучшению проекта	Открытое обсуждение
🗳️ Опросы	Опросы с несколькими вариантами для голосования и обсуждения в сообществе	Опросы
🙏 Вопросы и ответы	Вопросы для сообщества, на которые нужно дать ответ, в формате "вопрос/ответ"	Вопросы и ответы
🙌 Показывайте и рассказывайте	Любые создания, эксперименты или тесты, относящиеся к проекту	Открытое обсуждение

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

1. В разделе " Обсуждение" введите название для обсуждения и в разделе "Запись " введите текст обсуждения.

   

2. Выберите " Начать обсуждение".

Это описывает, как GitHub поддерживает совместную работу с помощью проблем и обсуждений. Теперь давайте перейдем к управлению уведомлениями, подпиской на потоки и начало работы со страницами GitHub.

Помечание комментария как ответа

В обсуждении стиля Q&A можно пометить комментарий как принятый ответ на исходный вопрос.

1. Перейдите к обсуждению.
2. Найдите комментарий, который лучше всего отвечает на исходный вопрос.
3. Выберите "Пометить как ответ " под комментарием.

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

Преобразование обсуждения в проблему

Если обсуждение ведет к работе, которую необходимо отслеживать, можно преобразовать обсуждение в проблему.

1. Перейдите к обсуждению, которое вы хотите преобразовать.
2. ... Выберите меню (три точки) в правом верхнем углу обсуждения.
3. Выберите Преобразовать в проблему.
4. Подтвердите преобразование и выберите репозиторий, чтобы создать новую проблему.

Это отслеживает действимную работу, которая происходит из бесед сообщества.

Закрепление обсуждения

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

1. Перейдите к обсуждению, которое вы хотите закрепить.
2. ... Выберите меню (три точки) в правом верхнем углу обсуждения.
3. Выберите "Закрепить обсуждение".

Закрепленные обсуждения полезны для выделения объявлений, важных вопросов или текущих тем, которые сообщество должно заметить.