Início Rápido para Discussões do GitHub

Introdução

GitHub Discussions é um fórum de comunicação colaborativo para a comunidade sobre um projeto de código aberto. As discussões são para conversas que precisam ser transparentes e acessíveis, mas não precisam ser rastreadas em um quadro de projeto e não estão relacionadas ao código, diferente de Problemas do GitHub. As discussões permitem uma conversa fluida e aberta em um fórum público.

As discussões dão um espaço para conversas mais colaborativas, conectando-se e dando uma área mais centralizada para se conectar e encontrar informações.

Habilitar GitHub Discussions no seu repositório

Os proprietários de repositórios e pessoas com acesso de escrita podem habilitar GitHub Discussions para uma comunidade nos seus repositórios públicos e privados.

Ao habilitar GitHub Discussions pela primeira vez, você será convidado a configurar um post de boas-vindas.

1. No GitHub.com, navegue até a página principal do repositório.
2. No nome do seu repositório, clique em Configurações.
3. Em "Recursos", clique em Configurar discussões.
4. Em "Iniciar uma nova discussão", edite o modelo para que fique alinhado aos recursos e tom que você deseja definir para sua comunidade.
5. Clique em Iniciar discussão.

Enabling GitHub Discussions on your organization

Organization owners can enable GitHub Discussions for their organization.

When you enable organization discussions, you will choose a repository in the organization to be the source repository for your organization discussions. You can use an existing repository or create a repository specifically to hold your organization discussions. Discussions will appear both on the discussions page for the organization and on the discussion page for the source repository.

Permission to participate in or manage discussion in your organization is based on permission in the source repository. For example, a user needs write permission to the source repository in order to delete an organization discussion. This is identical to how a user needs write permission in a repository in order to delete a repository discussion.

You can change the source repository at any time. If you change the source repository, discussions are not transferred to the new source repository.

1. Em GitHub.com, acesse a página principal da sua organização.
2. Under your organization name, click Settings.
3. Under "Discussions", select Enable discussions for this organization.
4. Select a repository to use as the source repository for your organization discussions.
5. Clique em Salvar.

Dar as boas-vindas às contribuições para as suas discussões

You can welcome your community and introduce a new way to communicate in a repository or organization by creating a welcome post and pinning the post to your GitHub Discussions page. Fixar e bloquear discussões ajuda as pessoas a saber que uma publicação é feita como um anúncio. Você pode usar os anúncios como uma forma de vincular pessoas a mais recursos e oferecer orientação para abrir discussões na sua comunidade. For more information about pinning a discussion, see "Managing discussions."

Configurar diretrizes da comunidade para colaboradores

For repository discussions, you can set contributing guidelines to encourage collaborators to have meaningful, useful conversations that are relevant to the repository. Você também pode atualizar o README do repositório para comunicar as expectativas quando os colaboradores devem abrir um problema ou discussão. Para obter mais informações sobre como fornecer diretrizes para o seu projeto, consulte "Adicionar um código de conduta ao seu projeto" e "Configurar seu projeto para contribuições saudáveis".

For organization discussions, you share information about how to engage with your organization by creating an organization profile README. Para obter mais informações, consulte "Personalizar o perfil da sua organização".

Criar uma nova discussão

Any authenticated user who can view the repository can create a discussion in that repository. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a discussion in that organization.

1. Em GitHub.com, navigate to the main page of the repository or organization where you want to start a discussion.
2. Under your repository or organization name, click Discussions.
3. Clique em Nova discussão.
4. Menu suspenso Selecionar categoria e clique em uma categoria para a sua discussão.
5. Digite um título e texto para sua discussão.
6. Clique em Iniciar discussão.

Creating a new poll

Any authenticated user who can view a repository can create a poll. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a poll in that organization.

1. No GitHub.com, navegue até a página principal do repositório.
2. Under your repository or organization name, click Discussions.
3. In the list of categories, click Polls.
4. On the right, click Start poll.
5. Type a title and optional body for your poll.
6. Type a question for your poll.
7. Type at least two options for your poll.
8. Optionally, to add a extra poll options, click Add an option.
9. Click Start poll.

Organizando discussões

Repository owners and people with write access to the repository can create new categories to keep discussions organized. Similarly, since organization discussions are based on a source repository, repository owners and people with write access to the source repository can create new categories for organization discussions.

Os colaboradores que participam e criam novas discussões podem agrupar discussões nas categorias existentes mais relevantes. As discussões também podem ser recategorizadas depois que forem criadas. For more information, see "Managing categories for discussions."

Para organizar as discussões de forma mais granular, você pode aplicar etiquetas. Por exemplo, você pode usar etiquetas para indicar o status de uma discussão para tornar a triagem mais eficiente. Cada repositório tem um conjunto compartilhado de etiquetas para problemas, pull requests e discussões. Para obter mais informações, consulte "Gerenciar etiquetas".

Promover conversas saudáveis

People with write permissions for the repository, or for the source repository for organization discussions, can help surface important conversations by pinning discussions, deleting discussions that are no longer useful or are damaging to the community, and transferring discussions to more relevant repositories owned by the organization. For more information, see "Managing discussions."

People with triage permissions for the repository, or for the source repository for organization discussions, can help moderate a project's discussions by marking comments as answers, locking discussions that are no longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. Para obter mais informações, consulte "Moderação de discussões".

Próximas etapas

Uma vez traçado um caminho claro para o definir o escopo do trabalho, deve-se concretizar a ideia. você pode criar um problema e começar a acompanhar seu progresso. Para obter mais informações sobre a criação de um problema a partir de uma discussão, consulte "Moderar discussões".