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

Habilite GitHub Discussions em um repositório existente e inicie conversas com 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, ao contrário dos problemas. 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 primeiro um GitHub Discussions, você será convidado a configurar uma mensagem de boas-vindas.

  1. No GitHub, 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 discussões 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"

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 comunicar-se em um repositório, criando um posts de boas-vindas e colocando 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 como fixar uma discussão, consulte "Gerenciar discussões no seu repositório".

Configurar diretrizes da comunidade para colaboradores

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".

Criar uma nova discussão

Qualquer pessoa com acesso a um repositório pode criar uma discussão.

  1. No GitHub, navegue até a página principal do repositório.
  2. No nome do seu repositório, clique em Discussões. 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"

Organizando discussões

Os proprietários dos repositórios e pessoas com acesso de gravação podem criar novas categorias para manter as discussões organizadas. 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 "Gerenciar categorias para discussões no seu repositório".

To organize discussions more granularly, you can apply labels. For example, you can use labels to indicate the status of a discussion to make triaging more efficient. Each repository has one shared set of labels for issues, pull requests, and discussions. Para obter mais informações, consulte "Gerenciar etiquetas".

Promover conversas saudáveis

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

Pessoas com permissões de triagem para um repositório 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ágios 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".

Esse documento ajudou você?Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.