Skip to main content

Colaboração com mantenedores usando as discussões

Você pode contribuir para objetivos, planos, saúde e comunidade para um projeto em GitHub Enterprise Cloud comunicando-se com os mantenedores do projeto em uma discussão.

Quem pode usar esse recurso?

People with read access to a repository can start and participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can start and participate in discussions and polls in the organization. Os membros de uma empresa com usuários gerenciados só podem interagir com os repositórios de suas empresas.

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 Enterprise Cloud. 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 obter mais informações, 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 obter mais informações, 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.

À medida que o seu projeto cresce, você pode conceder mais permissões de acesso aos integrantes ativos da sua comunidade. Para obter mais informações, confira "Conceder permissões superiores aos melhores colaboradores".

Captura de tela da página "Discussões" em um repositório. A seção "Mais útil" está contornada em laranja escuro.

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 obter mais informações, 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 obter mais informações, confira "Habilitar ou desabilitar discussões de GitHub para uma organização.".

Iniciar uma discussão

  1. No GitHub.com, navegue até a página principal do repositório ou da organização em que você deseja iniciar uma discussã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. No lado direito da página, clique em Nova discussão.

  4. Selecione uma categoria de discussão clicando em Introdução.

    Captura de tela da página "Selecionar uma categoria de discussão".  Um botão, rotulado como "Introdução", está contornado em laranja escuro.

  5. Em "Título da discussão", digite um título para sua discussão e, em "Gravar", digite o corpo da discussão.

    Captura de tela dos campos de texto do título e corpo para uma nova discussão.

  6. Clique em Iniciar discussão.

Iniciar um poll

  1. No GitHub.com, navegue até 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 categorias, clique em Votações.

    Captura de tela da seção de categorias na guia "Discussões". A categoria "Votação" é descrita em laranja escuro.

  4. Com o botão direito, clique em Nova discussão.

  5. Em "Título da discussão", digite um título e, opcionalmente, em "Gravar", digite um corpo para sua votação.

    Captura de tela da página para iniciar uma nova votação.

  6. Em "Pergunta de votação", digite uma pergunta para sua votação.

  7. Em "Opções de votação", digite pelo menos duas opções para sua votação.

  8. Opcionalmente, para adicionar uma opção de sondagem extra, clique em Adicionar uma opção.

    Captura de tela da página para iniciar uma nova votação. O ícone de adição e "Adicionar uma opção" estão contornados em laranja escuro.

  9. 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 obter mais informações, confira "Pesquisar discussões".

  1. No GitHub.com, navegue até a página principal do repositório ou da 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. 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.

    Captura de tela da barra de pesquisa e dos botões para filtrar discussões.

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

  1. No GitHub.com, navegue até a página principal do repositório ou da 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. À direita do campo Pesquisar todas as discussões, selecione o menu suspenso Classificar por e clique em um período.

    Captura de tela de uma linha de botões para classificar discussões. Um botão rotulado como "Classificar por: atividade mais recente" é realçado com um contorno laranja.

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

  1. No GitHub.com, navegue até a página principal do repositório ou da 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 postagem da discussão principal, selecione Mais Antigos, Mais Recentes ou Principais.

    Captura de tela de uma discussão. Os botões para classificar comentários em discussões estão contornados em laranja escuro.

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

Leitura adicional