GitHub Discussion: O que é isso e pra que serve?

Pachi 🥑 - Apr 12 '23 - - Dev Community

Fala galera tecnologista!

Hoje eu vim compartilhar com vocês uma feature do GitHub que eu acho muito legal, mas poucas pessoas falam sobre: o GitHub Discussions.

Não seria legal ter um espaço para trocar ideias e fazer perguntas, dentro do GitHub de um projeto, mas fora das issues? Pois é isso que o Discussions oferece.

https://github.com/features/discussions

O que é?

GitHub Discussions é um fórum dentro do GitHub, que pode ser usado em um repositório ou em uma organização. Dentro dele você pode fazer perguntas, compartilhar ideias e criar conexões com outras pessoas que contribuem para os mesmo projetos que você ou fazem parte da mesma org.

Mas eu já faço perguntas nas issues, pra que usar o Discussion?

Issues e PRs são ótimos lugares para tirar dúvidas, mas apenas quando essas são diretamente relacionadas ao assunto daquela Issue ou PR. Às vezes sua dúvida pode ser algo mais generalizado ou específico, ou você tem uma ideia legal para compartilhar.

O Discussion te oferece um espaço separado para que você possa fazer isso, que fica visível a todas as pessoas com acesso ao repositório ou organização, então mais pessoas podem opinar nas suas sugestões e te ajudar com suas dúvidas.

De bônus, as Issues e PRs ficam mais limpas e focadas, o que ajuda muito as pessoas que mantêm o projeto.

O que o Discussion oferece de legal?

Como comentei, Discussion é um fórum dentro do GitHub e nele você encontra várias ferramentas legais e úteis para ajudar na troca de ideias e conexão da sua organização ou projeto.

  • Você pode marcar as melhores respostas fazendo com que elas fiquem em destaque ajudando assim outras pessoas com a mesma dúvida a encontrarem a resposta certa com mais facilidade

  • Usar threads dentro de uma postagem para manter o contexto das conversas

  • Criar enquetes para realizar pesquisas dentro da sua comunidade

  • Se uma conversa virar uma tarefa, você pode transformá-la em uma issue

  • Colocar anúncios e conversas em destaque, no topo da página principal

E essas são só algumas das ferramentas que o GitHub Discussion te oferece.

Como configurar?

O GitHub Discussion precisa ser habilitado dentro de um repositório ou de uma organização para ser utilizado.

Para habilitá lo dentro de um repositório, vá nas configurações do repositório:

ilustracao de onde char configurações

Dentro das configurações, navegue para baixo até encontrar a opção Discussions, aonde você vai marcar a caixinha e logo após clicar no botão verde Set up discussions:

tutorial

Isso vai te levar para sua primeira Conversa dentro do Discussion, o post de boas vindas. O GitHub te dá um template em inglês, mas você pode criar sua mensagem de boas vindas do 0, escrevendo o que faz mais sentido para sua comunidade.

exemplo de boas vindas

Agora, para habilitar o Discussions dentro de uma organização, apenas as pessoas com autorização podem fazer isso.

Ao habilitar as discussões da organização, você escolherá um repositório da organização para ser o repositório de origem do Discussion.

  • Primeiramente vá a página principal da org, e lá clique em settings

  • Na barra de tarefas da esquerda, procure e clique em Discussions

  • Aqui você vai clicar na caixinha azul, e escolher qual será o repositório onde seu Discussion vai ficar

  • Pronto, agora é só configurar como achar melhor

  • painel discussions

discussions org

Conversas organizadas, o desafio

O GitHub Discussion é uma ferramenta muito legal que pode ser usada para organizar projetos Open Source, Comunidades ou até times dentro de uma empresa.

Espero que o artigo de hoje tenha sido útil para vocês e que comecem a usar essa ferramenta.

*O desafio dessa semana é criar um GitHub Discussion no repositório que você mais usa ou em alguma organização que você ajuda a organizar.
*

Abraço, e obrigada por ler <3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .