157 lines
16 KiB
Markdown
157 lines
16 KiB
Markdown
---
|
||
title: Взаимодействие с GitHub
|
||
intro: 'Вы можете обсудить конкретные проекты и изменения, а также более общие идеи и цели команды, используя различные типы обсуждений в {% data variables.product.product_name %}.'
|
||
miniTocMaxHeadingLevel: 3
|
||
redirect_from:
|
||
- /github/collaborating-with-issues-and-pull-requests/getting-started/quickstart-for-communicating-on-github
|
||
- /articles/about-discussions-in-issues-and-pull-requests
|
||
- /github/collaborating-with-issues-and-pull-requests/about-conversations-on-github
|
||
- /github/collaborating-with-issues-and-pull-requests/quickstart-for-communicating-on-github
|
||
- /github/getting-started-with-github/quickstart/communicating-on-github
|
||
versions:
|
||
fpt: '*'
|
||
ghes: '*'
|
||
ghae: '*'
|
||
ghec: '*'
|
||
topics:
|
||
- Pull requests
|
||
- Issues
|
||
- Discussions
|
||
- Fundamentals
|
||
ms.openlocfilehash: 18321069abd4fb48956f4d61653b8bbe592c648b
|
||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||
ms.translationtype: MT
|
||
ms.contentlocale: ru-RU
|
||
ms.lasthandoff: 10/25/2022
|
||
ms.locfileid: '148106792'
|
||
---
|
||
## Введение
|
||
|
||
{% data variables.product.product_name %} предоставляет встроенные средства общения для совместной работы, чтобы вы могли взаимодействовать с сообществом. В этом кратком руководстве показано, как выбрать подходящее средство для ваших потребностей.
|
||
|
||
{% ifversion discussions %} Вы можете создавать проблемы, запросы на вытягивание, {% data variables.product.prodname_discussions %} и обсуждения в команде, а также участвовать в них, в зависимости от требуемого типа обсуждения.
|
||
{% else %} Вы можете создавать проблемы, запросы на вытягивание и обсуждения в команде, а также участвовать в них, в зависимости от требуемого типа обсуждения.
|
||
{% endif %}
|
||
|
||
### {% data variables.product.prodname_github_issues %}
|
||
- удобны для обсуждения конкретных сведений о проекте, например для отчетов об ошибках, сведений о запланированных улучшениях и отзывов;
|
||
- относятся к конкретному репозиторию и обычно имеют конкретного владельца;
|
||
- часто называются системой отслеживания ошибок {% data variables.product.prodname_dotcom %}.
|
||
|
||
### Запросы на вытягивание
|
||
- позволяют предлагать конкретные изменения;
|
||
- позволяют напрямую комментировать предложенные другими пользователями изменения;
|
||
- относятся к конкретному репозиторию.
|
||
|
||
{% ifversion fpt or ghec %}
|
||
### {% data variables.product.prodname_discussions %}
|
||
- выполняют роль форума, который лучше всего подходит для обсуждения в свободной форме идей и планов, требующих общего участия;
|
||
- могут охватывать множество репозиториев;
|
||
- предоставляют возможность совместной работы без привязки к базе кода, например для мозгового штурма идей и наработки базы знаний сообщества;
|
||
- часто не имеют конкретного владельца;
|
||
- часто используются не для создания конкретной задачи.
|
||
{% endif %}
|
||
|
||
### Обсуждения в команде
|
||
- могут создаваться на странице обсуждения в команде, и могут охватывать несколько проектов без привязки к определенной проблеме или запросу на вытягивание. Вместо того, чтобы открыть вопрос в репозитории для обсуждения идеи, вы можете привлечь к беседе всю команду, проведя обсуждение в команде.
|
||
- позволяют проводить с командой обсуждения для планирования, анализа, проектирования, изучения реакции пользователей и принятия решений общего характера по проекту; {% ifversion ghes or ghae %}
|
||
- обеспечивают совместную работу за пределами базы кода, позволяя проводить мозговой штурм идей;
|
||
- часто не имеют конкретного владельца;
|
||
- часто используются не для создания конкретной задачи.{% endif %}
|
||
|
||
## Какие средства для обсуждений мне подходят?
|
||
|
||
### Сценарии проблем
|
||
|
||
- Я хочу отслеживать задачи, улучшения и ошибки.
|
||
- Я хочу отправить отчет об ошибке.
|
||
- Я хочу поделиться отзывами о конкретной функции.
|
||
- Я хочу задать вопрос о файлах в репозитории.
|
||
|
||
#### Пример проблемы
|
||
|
||
В этом примере показано, как пользователь {% data variables.product.prodname_dotcom %} создает проблему в нашем репозитории с открытым кодом для документации, чтобы сообщить об ошибке и обсудить исправление.
|
||
|
||
|
||
|
||
- Пользователь заметил, что синий цвет баннера в верхней части страницы в китайской версии документов {% data variables.product.prodname_dotcom %} делает текст баннера нечитаемым.
|
||
- Пользователь создал в репозитории проблему с описанием ситуации и предложил решение (использовать для баннера другой цвет фона).
|
||
- По этому решению проводится обсуждение и достигается консенсус.
|
||
- Затем участник может создать запрос на вытягивание с исправлением.
|
||
|
||
### Сценарии для запросов на вытягивание
|
||
|
||
- Я хочу исправить опечатку в репозитории.
|
||
- Я хочу внести изменения в репозиторий.
|
||
- Я хочу внести изменения, чтобы устранить проблему.
|
||
- Я хочу комментировать изменения, предложенные другими.
|
||
|
||
#### Пример для запроса на вытягивание
|
||
|
||
В этом примере показано, как пользователь {% data variables.product.prodname_dotcom %} создал запрос на вытягивание в нашем репозитории с открытым кодом для документации, чтобы исправить опечатку.
|
||
|
||
На вкладке **Обсуждение** для запроса на вытягивание автор объясняет, почему он создал этот запрос на вытягивание.
|
||
|
||
|
||
|
||
На вкладке **Измененные файлы** для на вытягивание отображается внесенное исправление.
|
||
|
||
|
||
|
||
- Этот участник замечает опечатку в репозитории.
|
||
- Этот пользователь создает запрос на вытягивание с исправлением.
|
||
- Хранитель репозитория проверяет запрос на вытягивание, изучает комментарии к нему и объединяет его.
|
||
|
||
{% ifversion discussions %}
|
||
### Сценарии для {% data variables.product.prodname_discussions %}
|
||
|
||
- У меня есть вопрос, который не связан с конкретными файлами в репозитории.
|
||
- Я хочу делиться новостями с коллегами или командой.
|
||
- Я хочу начать открытую беседу или стать ее участником.
|
||
- Я хочу сделать объявление в сообществе.
|
||
|
||
#### Пример {% data variables.product.prodname_discussions %}
|
||
|
||
В этом примере показано создание приветственной записи в {% data variables.product.prodname_discussions %} для репозитория {% data variables.product.prodname_dotcom %} с открытым кодом для документации, и описаны предпочтительные методы общения в сообществе для команды.
|
||
|
||
|
||
|
||
Этот хранитель сообщества начал обсуждение, чтобы приветствовать участников и предложить всем представиться. Такая запись способствует созданию комфортной атмосферы для посетителей и участников. В этом же сообщении объясняется, что команда будет рада помочь в создании вкладов в репозиторий.
|
||
|
||
{% endif %}
|
||
### Сценарии для обсуждений в команде
|
||
|
||
- У меня есть вопрос, который не связан с конкретными файлами в репозитории.
|
||
- Я хочу делиться новостями с коллегами или командой.
|
||
- Я хочу начать открытую беседу или стать ее участником.
|
||
- Я хочу сделать объявление для своей команды.
|
||
|
||
{% ifversion fpt or ghec %} Как видите, обсуждения в команде очень похожи на {% data variables.product.prodname_discussions %}. Для {% data variables.product.prodname_dotcom_the_website %} рекомендуется использовать {% data variables.product.prodname_discussions %} в качестве начальной точки для бесед. Вы можете использовать {% data variables.product.prodname_discussions %} для совместной работы с любым сообществом в {% data variables.product.prodname_dotcom %}. Если вы являетесь членом организации и хотите инициировать обсуждение в рамках всей организации или отдельной ее команды, следует использовать обсуждения в команде.
|
||
{% endif %}
|
||
|
||
#### Пример обсуждения в команде
|
||
|
||
В этом примере показана запись в обсуждении для команды `octo-team`.
|
||
|
||
|
||
|
||
Участник команды `octocat` опубликовал обсуждение в команде, чтобы проинформировать всех ее участников о нескольких вещах.
|
||
- Участник команды Mona начал события для удаленной игры.
|
||
- Есть запись блога с описанием того, как команды используют {% data variables.product.prodname_actions %} для создания своих документов.
|
||
- Материал о мероприятии April All Hands теперь доступен для просмотра всем участникам команды.
|
||
|
||
## Дальнейшие действия
|
||
|
||
На этих примерах вы узнали, как выбрать оптимальный инструмент для обсуждения в {% data variables.product.product_name %}. Но это только начало, ведь у вас есть много возможностей адаптировать эти средства под ваши потребности.
|
||
|
||
Для проблем: можно присвоить проблемам метки для быстрого поиска или создать шаблоны проблем, чтобы помочь участникам открывать проблемы с подробным описанием. Дополнительные сведения см. в статьях [Сведения о проблемах](/github/managing-your-work-on-github/about-issues#working-with-issues) и [Сведения о шаблонах проблем и запросов на вытягивание](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates).
|
||
|
||
Для запросов на вытягивание: можно создать черновик запросов на вытягивание, если работа над предлагаемыми изменениями может затянуться. Черновик запросов на вытягивание не может быть объединен, пока не будет помечен как готовый к проверке. Дополнительные сведения см. в разделе [Сведения о запросах на вытягивание](/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests).
|
||
|
||
{% ifversion discussions %} Для {% data variables.product.prodname_discussions %}: можно{% ifversion fpt or ghec %} настроить кодекс поведения и{% endif %} закрепить обсуждения c важной информацией для сообщества. Дополнительные сведения см. в разделе [Сведения об обсуждениях](/discussions/collaborating-with-your-community-using-discussions/about-discussions).
|
||
{% endif %}
|
||
|
||
Для обсуждений в команде: можно редактировать или удалять обсуждения на странице команды, а также настраивать уведомления для обсуждений в команде. Дополнительные сведения см. в разделе [Сведения об обсуждениях в команде](/organizations/collaborating-with-your-team/about-team-discussions).
|
||
|
||
Дополнительные сведения о функциях форматирования, которые помогут вам общаться, см. в разделе [Краткое руководство по написанию {% data variables.product.prodname_dotcom %}](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github).
|