Sobre o gerenciamento de discussões
O GitHub Discussions é um fórum aberto para conversa entre mantenedores e a comunidade de um projeto no GitHub. Para obter mais informações sobre as discussões, confira "Sobre discussões".
Os proprietários da organização podem escolher as permissões necessárias para criar uma discussão em repositórios pertencentes à organização. Da mesma forma, para escolher as permissões necessárias para criar uma discussão da organização, os proprietários da organização podem alterar as permissões necessárias no repositório de origem. Para obter mais informações, confira "Gerenciar criação de discussões para repositórios na sua organização".
Como mantenedor de discussões, você pode criar recursos da comunidade para incentivar discussões alinhadas com o objetivo geral do projeto e manter um fórum aberto amigável para os colaboradores. Criar um código de conduta ou diretrizes de contribuição para os colaboradores a seguir ajudará a facilitar um fórum colaborativo e produtivo. Para obter mais informações sobre como criar recursos da comunidade, confira "Adding a code of conduct to your project" e "Configurar diretrizes para os contribuidores do repositório".
Quando uma discussão fornece uma ideia ou um erro que está pronto para ser trabalhado, você pode criar um novo problema a partir de uma discussão. Para obter mais informações, confira "Criar um problema".
É possível fixar uma discussão no topo da lista de discussões do repositório ou da organização. Também é possível fixar uma discussão em uma categoria específica. Para saber mais, confira "Gerenciando discussões".
Para obter mais informações sobre como facilitar uma discussão útil, confira "Moderar comentários e conversas".
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, confira "Gerenciar etiquetas".
Pré-requisitos
Para gerenciar as discussões em um repositório, GitHub Discussions deve estar habilitado para o repositório. Para obter mais informações, confira "Habilitar ou desabilitar discussões no GitHub para um repositório".
Para gerenciar as discussões em uma organização, o GitHub Discussions deve estar habilitado na organização. Para obter mais informações, confira "Habilitar ou desabilitar discussões de GitHub para uma organização.".
Alterar a categoria para uma discussão
Você pode categorizar discussões para ajudar os integrantes da comunidade a encontrar discussões relacionadas. Para obter mais informações, confira "Gerenciar categorias para discussões".
Você também pode mover a discussão para uma categoria diferente. Não é possível mover uma discussão para ou da categoria de votação.
-
No GitHub.com, navegue até a página principal do repositório. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na barra lateral direita, à direita da "Categoria", clique em .
-
Clique em uma categoria.
Fixar uma discussão
É possível fixar uma discussão acima da lista de discussões do repositório ou da organização. Também é possível fixar uma discussão em uma categoria específica. Além das discussões fixadas em uma categoria específica, também serão mostradas as discussões fixadas globalmente.
É assim que funciona quando você tem uma discussão fixada globalmente e uma discussão fixada na categoria “Ideias”.
Fixar uma discussão globalmente
Você pode fixar até quatro discussões importantes acima da lista de discussões do repositório ou da organização.
-
No GitHub.com, navegue até a página principal do repositório ou da organização. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na barra lateral direita, clique em Fixar discussão.
-
Opcionalmente, personalize a aparência da discussão fixada.
-
Clique em Fixar discussão.
Fixar uma discussão em uma categoria
É possível fixar até quatro discussões importantes acima da lista de discussões em uma categoria específica.
-
No GitHub.com, navegue até a página principal do repositório ou da organização. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na barra lateral direita, clique em Fixar discussão na CATEGORIA.
-
Para confirmar, clique em Fixar na CATEGORIA.
Editar uma discussão fixada
Editar uma discussão fixada não irá alterar a categoria da discussão. Para obter mais informações, confira "Gerenciar categorias para discussões".
-
No GitHub.com, navegue até a página principal do repositório ou da organização. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na barra lateral direita, clique em Editar discussão fixa.
-
Personalize a aparência da discussão fixada.
-
Clique em Fixar discussão.
Desafixar uma discussão
É possível desafixar uma discussão da lista de discussões do repositório ou da organização ou da lista de discussões em uma categoria específica.
Desafixar uma discussão fixada globalmente
É possível desafixar uma discussão fixada globalmente. Isso não a excluirá, mas ela não será mais exibida acima da lista de discussões.
-
No GitHub.com, navegue até a página principal do repositório ou da organização. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na barra lateral direita, clique em Desafixar discussão.
-
Leia o aviso e clique em Desafixar discussão.
Desafixar uma discussão de uma categoria
É possível desafixar uma discussão fixada em uma categoria específica. Isso não a excluirá, mas ela não será mais exibida no topo da categoria.
-
No GitHub.com, navegue até a página principal do repositório ou da organização. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na barra lateral direita, clique em Desafixar discussão desta categoria.
-
Leia o aviso e clique em Desafixar desta categoria.
Transferir uma discussão
Para transferir uma discussão, você precisa ter permissão de criar discussões no repositório, em que você deseja transferir a discussão. Se você quiser transferir uma discussão para uma organização, deverá ter permissões para criar discussões no repositório de origem das discussões da organização. Você somente pode transferir discussões entre repositórios pertencentes à mesma conta de usuário ou organização. Você não pode transferir uma discussão de um repositório privado para um repositório público.
-
No GitHub.com, navegue até a página principal do repositório ou da organização. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na barra lateral direita, clique em Transferir esta discussão.
-
Selecione o repositório para o qual deseja transferir a discussão. Também é possível procurar repositórios. Se você quiser transferir uma discussão para uma organização, escolha o repositório de origem das discussões da organização.
-
Clique em Transferir discussão.
Excluir uma discussão
-
No GitHub.com, navegue até a página principal do repositório ou da organização. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na barra lateral direita, clique em Excluir discussão.
-
Leia o aviso e clique em Excluir esta discussão.
Como encerrar uma discussão
Você pode fechar uma discussão quando a discussão foi resolvida, não é mais relevante ou é uma duplicata.
-
No GitHub.com, navegue até a página principal do repositório ou da organização. 1. No nome de seu repositório ou organização, clique em Discussões.
-
Na parte inferior da discussão, abaixo da caixa de comentários, clique em Fechar discussão.
-
Opcionalmente, para alterar o motivo de fechamento da discussão, selecione o menu suspenso ao lado de "Fechar discussão" e clique em um motivo.
Converter problemas com base em etiquetas
Você pode converter todos as etiquetas com a mesma etiqueta para discussões em massa. Os problemas futuros com essa etiqueta também serão automaticamente convertidos em discussão e categoria que você configurar.
- No GitHub.com, acesse a página principal do repositório ou, para discussões da organização, o repositório de origem.
- No nome do seu repositório, clique em Problemas.
- Ao lado do rótulo que deseja converter em problemas, clique em Converter problemas.
- Selecione o menu suspenso Escolher uma categoria e clique em uma categoria para ver a discussão.
- Clique em Entendi. Converter este problema em uma discussão.
