Gerenciando discussões

Você pode categorizar, destacar e transferir ou excluir as discussões.

Quem pode usar esse recurso?

Repository administrators and people with triage or greater access to a repository can manage discussions in the repository. Repository administrators and people with triage or greater access to the source repository for organization discussions can manage discussions in the organization.

Neste artigo

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 saber mais, 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 Adicionar um código de conduta ao seu projeto 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 saber mais, 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 saber mais, 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 saber mais, 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 saber mais, 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.

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na barra lateral direita, à direita da "Categoria", clique em .

  5. 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”.

Captura de tela de uma discussão fixada globalmente e de 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.

  1. Em GitHub, navegue até a página principal do repositório ou organização.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na barra lateral direita, clique em Fixar discussão.

    Captura de tela da barra lateral direita de uma discussão. A opção "Fixar discussão" é realçada com um contorno laranja.

  5. Opcionalmente, personalize a aparência da discussão fixada.

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

  1. Em GitHub, navegue até a página principal do repositório ou organização.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na barra lateral direita, clique em Fixar discussão em CATEGORIA.

    Captura de tela da barra lateral direita de uma discussão. A opção "Fixar discussão no Q&A" está contornada em laranja escuro.

  5. 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 saber mais, confira Gerenciar categorias para discussões.

  1. Em GitHub, navegue até a página principal do repositório ou organização.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na barra lateral direita, clique em Editar discussão fixada.

    Captura de tela da barra lateral direita de uma discussão. A opção "Editar discussão fixada" está contornada em laranja escuro.

  5. Personalize a aparência da discussão fixada.

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

  1. Em GitHub, navegue até a página principal do repositório ou organização.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na barra lateral direita, clique em Desafixar discussão.

    Captura de tela da barra lateral direita de uma discussão. A opção "Desafixar discussão" está realçada com um contorno laranja.

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

  1. Em GitHub, navegue até a página principal do repositório ou organização.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na barra lateral direita, clique em Desafixar discussão desta categoria.

    Captura de tela da barra lateral direita de uma discussão. A opção "Desafixar discussão desta categoria" está contornada em laranja escuro.

  5. 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. Além disso, você não poderá transferir discussões se forem comunicados. Para saber mais, confira Gerenciar categorias para discussões.

  1. Em GitHub, navegue até a página principal do repositório ou organização.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na barra lateral direita, clique em Transferir esta discussão.

    Captura de tela da barra lateral direita de uma discussão. A opção "Transferir esta discussão" está contornada em laranja escuro.

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

  6. Clique em Transferir discussão.

Excluir uma discussão

  1. Em GitHub, navegue até a página principal do repositório ou organização.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na barra lateral direita, clique em Excluir discussão.

    Captura de tela da barra lateral direita de uma discussão. A opção "Excluir discussão" está contornada em laranja escuro.

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

  1. Em GitHub, navegue até a página principal do repositório ou organização.

  2. No nome do repositório ou da organização, clique em Discussões.

    Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.

  3. Na lista de discussões, clique na discussão que você deseja visualizar.

  4. Na parte inferior da discussão, abaixo da caixa de comentários, clique em Fechar discussão.

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

  1. Navegue até a página principal do repositório ou, para discussões da organização, até o repositório de origem.

  2. No nome do seu repositório, clique em Problemas.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Problemas", é destacada em laranja escuro.

  3. Acima da lista de problemas ou solicitações de pull, clique em Rótulos.

    Captura de tela da lista de problemas de um repositório. Acima da lista, há um botão com um ícone de rótulo "Rótulos" e o contorno em laranja escuro.

  4. Ao lado do rótulo que deseja converter em problemas, clique em Converter problemas.

  5. Selecione o menu suspenso Escolher uma categoria e clique em uma categoria para ver a discussão.

  6. Clique em Entendi. Converter este problema em uma discussão.