Sobre colaboração com mantenedores que usam GitHub Discussions
O GitHub Discussions é um fórum aberto para conversa entre mantenedores e a comunidade de um projeto no GitHub. Se você usar ou contribuir para um projeto, você pode iniciar uma discussão para fazer sugestões e envolver-se com mantenedores e integrantes da comunidade sobre seus planos, dúvidas, ideias e feedback. Para saber mais, confira Sobre discussões.
Todas as discussões devem ser criadas em uma categoria. Para discussões do repositório, as pessoas com permissões de manutenção ou administrador no repositório definem as categorias para discussões nesse repositório. Para discussões da organização, as pessoas com permissões de manutenção ou administrador no repositório de origem definem as categorias para discussões nessa organização. Cada categoria tem um formato: discussão aberta, pergunta e resposta ou anúncio. Os mantenedores podem usar categorias com o formato do anúncio para compartilhar informações, versões ou eventos. Para manter as discussões nessas categorias focadas em atualizações importantes, apenas pessoas com permissões de manutenção ou administração podem criar novas discussões, mas qualquer pessoa pode comentar e responder.
Os administradores de repositório e mantenedores de projeto podem excluir uma discussão nesse repositório. Da mesma forma, administradores e responsáveis do repositório de origem para discussões de uma organização podem excluir uma discussão nessa organização. Para saber mais, confira Gerenciando discussões.
GitHub reconhecerá automaticamente os integrantes da comunidade que contribuem com a maioria dos comentários marcados como respostas para discussões com um formato de pergunta/resposta. Estes membros são exibidos em uma lista dos colaboradores mais úteis para as discussões do projeto, caso as configurações de privacidade permitam. Para obter mais informações, confira Definir seu perfil como privado.
À medida que o seu projeto cresce, você pode conceder mais permissões de acesso aos integrantes ativos da sua comunidade. Para saber mais, confira Conceder permissões superiores aos melhores colaboradores.
Os membros da comunidade podem votar a favor de discussões e comentários de alto nível dentro das discussões para se comunicar com os mantenedores sobre ideias importantes para eles. Os mantenedores do projeto podem classificar as discussões e os comentários com base nos votos a favor para obter insights sobre o que os membros da comunidade valorizam.
Para obter mais informações sobre a participação nas discussões, confira Participando de uma discussão.
Pré-requisitos
Para colaborar com responsáveis em discussões no repositório, um administrador ou mantenedor do projeto deverá habilitar GitHub Discussions para o repositório. Para saber mais, confira Habilitar ou desabilitar discussões no GitHub para um repositório.
Para colaborar com responsáveis em discussões da organização, o GitHub Discussions deve estar habilitado para a organização. Para saber mais, confira Habilitar ou desabilitar discussões de GitHub para uma organização..
Iniciar uma discussão
-
Em GitHub, navegue até a página principal do repositório ou organização na qual você deseja iniciar uma discussão.
-
No nome do repositório ou da organização, clique em Discussões.
-
No lado direito da página, clique em Nova discussão.
-
Selecione uma categoria de discussão clicando em Introdução.
-
Em "Título da discussão", digite um título para sua discussão e, em "Gravar", digite o corpo da discussão.
-
Clique em Iniciar discussão.
Iniciar um poll
-
Em GitHub, acesse a página principal do repositório.
-
No nome do repositório ou da organização, clique em Discussões.
-
Na lista de categorias, clique em Votações.
-
Com o botão direito, clique em Nova discussão.
-
Em "Título da discussão", digite um título e, opcionalmente, em "Gravar", digite um corpo para sua votação.
-
Em "Pergunta de votação", digite uma pergunta para sua votação.
-
Em "Opções de votação", digite pelo menos duas opções para sua votação.
-
Opcionalmente, para adicionar uma opção de sondagem extra, clique em Adicionar uma opção.
-
Clique em Iniciar votação.
Filtrar a lista de discussões
É possível pesquisar discussões e filtrar a lista de discussões em um repositório ou uma organização. Para saber mais, confira Pesquisar discussões.
-
Em GitHub, navegue até a página principal do repositório ou organização.
-
No nome do repositório ou da organização, clique em Discussões.
-
No campo Pesquisar todas as discussões, digite uma consulta de pesquisa. Opcionalmente, à direita do campo de pesquisa, clique em um botão para filtrar ainda mais os resultados.
-
Na lista de discussões, clique na discussão que você deseja visualizar.
Como classificar a lista de discussões
Você pode escolher como classificar a lista de discussões.
-
Em GitHub, navegue até a página principal do repositório ou organização.
-
No nome do repositório ou da organização, clique em Discussões.
-
À direita do campo Pesquisar todas as discussões, selecione o menu suspenso Classificar por e clique em um período.
- Classifique o conteúdo por Atividade mais recente para exibir as discussões com a atividade mais recente no início da lista.
- Classifique por Data de criação para exibir na parte superior da lista as discussões que foram criadas mais recentemente.
- Classifique o conteúdo por Principais para exibir as discussões com o maior número de votos a favor no início da lista. Você pode limitar a lista para exibir apenas as discussões de um período específico.
Como classificar comentários de nível superior nas discussões
Você pode escolher como classificar os comentários de nível superior nas discussões. As conversas de comentários não afetam a ordem em que os comentários são classificados.
-
Em GitHub, navegue até a página principal do repositório ou organização.
-
No nome do repositório ou da organização, clique em Discussões.
-
Na lista de discussões, clique na discussão que você deseja visualizar.
-
Na postagem da discussão principal, selecione Mais Antigos, Mais Recentes ou Principais.
- Classifique o conteúdo por Mais Antigos para exibir os comentários de nível superior mais antigos primeiro.
- Classifique o conteúdo por Mais Recentes para exibir os comentários de nível superior mais recentes primeiro.
- Classifique o conteúdo por Principais para exibir os comentários de nível superior mais votados a favor primeiro.
Converter um problema em uma discussão
Se um problema for uma pergunta ou conversa aberta em vez de um item de trabalho para rastrear e priorizar, você poderá converter o problema em uma discussão. Para obter mais informações, confira Moderar discussões.