Skip to main content

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

Habilite o GitHub Discussions em um repositório ou organização existente e inicie conversas com a sua comunidade.

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. Botão de configurações públicas
  3. Em "Recursos", clique em Configurar discussões. Configure um botão de discussão em "Recursos" para habilitar ou desabilitar as Discussões do GitHub para um repositório
  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. Botão "Iniciar discussão"

Habilitando GitHub Discussions na sua organização

Os proprietários da organização podem habilitar GitHub Discussions para a sua organização.

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. Botão de configurações da organização
  3. Under "Discussions", select Enable discussions for this organization.
  4. Select a repository to use as the source repository for your organization discussions. Settings to enable discussions for an organization
  5. Clique em Salvar.

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

Você pode dar as boas-vindas à sua comunidade e apresentar uma nova forma de se comunicar em um repositório ou organização, criando um post de boas-vindas e fixando o post na sua página de GitHub Discussions. 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. Para obter mais informações sobre fixação de uma discussão, consulte "Gerenciando as discussões".

Configurar diretrizes da comunidade para colaboradores

Para discussões de repositório, você pode definir diretrizes de contribuição para incentivar os colaboradores a terem conversas significativas e úteis que sejam relevantes para o repositório. 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".

Para discussões na organização, você compartilha informações sobre como se envolver com a sua organização criando um perfil README da organização. Para obter mais informações, consulte "Personalizar o perfil da sua organização".

Criar uma nova discussão

Qualquer usuário autenticado que possa visualizar o repositório pode criar uma discussão nesse repositório. Da mesma forma, uma vez que as discussões da organização são baseadas em um repositório de origem, qualquer usuário autenticado que possa visualizar o repositório de origem pode criar uma discussão nessa organização.

  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. Aba "Discussões" de um repositório
  3. Clique em Nova discussão. Botão "Nova discussão" dentro da aba "Discussões" para um repositório
  4. Menu suspenso Selecionar categoria e clique em uma categoria para a sua discussão. Menu suspenso "Selecionar categoria" e lista de categorias disponíveis em repositório
  5. Digite um título e texto para sua discussão. Campos de texto para o título e texto da nova discussão
  6. Clique em Iniciar discussão. Botão "Iniciar discussão"

Criando uma nova enquete

Qualquer usuário autenticado que possa visualizar um repositório pode criar uma enquete. Da mesma forma, uma vez que as discussões da organização são baseadas em um repositório de origem, qualquer usuário autenticado que possa visualizar o repositório de origem pode criar uma enquete nessa organização.

  1. No GitHub.com, navegue até a página principal do repositório.
  2. Under your repository or organization name, click Discussions. Aba "Discussões" de um repositório
  3. In the list of categories, click Polls. Screenshot showing "Poll" category
  4. On the right, click Start poll. Screenshot showing the "Start poll" button
  5. Type a title and optional body for your poll. Screenshot showing text fields for title and body
  6. Type a question for your poll. Screenshot showing text fields for the poll's question
  7. Type at least two options for your poll. Screenshot showing text fields for the poll's options
  8. Optionally, to add a extra poll options, click Add an option. Screenshot showing "Add an option" button
  9. Click Start poll. Screenshot showing the "Start poll" button

Organizando discussões

Os proprietários dos repositórios e pessoas com acesso de gravação ao repositório podem criar novas categorias para manter as discussões organizadas. Da mesma forma, uma vez que as discussões da organização são baseadas em um repositório de origem, os proprietários de repositórios e as pessoas com acesso de gravação ao repositório de origem podem criar novas categorias para discussões da organização.

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. Para obter mais informações, consulte "Gerenciando categorias para discussões".

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

As pessoas com permissões de gravação no repositório ou no repositório de origem para discussões na organização podem ajudar a supervisionar conversas importantes fixando discussões, excluindo discussões que não são mais úteis ou são prejudiciais para a comunidade, e transferir discussões para repositórios mais relevantes pertencentes à organização. Para obter mais informações, consulte "Gerenciando discussões".

As pessoas com permissões de triagem no repositório ou no repositório de origem para discussões da organização podem ajudar a moderar as discussões de um projeto marcando comentários como respostas, bloqueando discussões que já não são úteis ou prejudicam a comunidade e convertendo os problemas em discussões quando uma ideia ainda está nos primeiros estádios de desenvolvimento. 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".