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 saber mais, 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 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. 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 Pin discussion.

    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 Pin discussion to CATEGORY.

    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 Edit pinned discussion.

    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 Unpin discussion.

    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 Unpin discussion from this category.

    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 Transfer this discussion.

    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 Delete discussion.

    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.