Introdução
GitHub Discussions é um fórum de comunicação colaborativo para a comunidade sobre um projeto interno ou de software livre. As discussões são para conversas que precisam ser transparentes e acessíveis, mas não precisam ser rastreadas em um projeto e não estão relacionadas ao código, diferente de GitHub Issues. As discussões permitem uma conversa fluida e aberta em um fórum público.
As discussões dão um espaço para conversas mais colaborativas, conectando-se e dando uma área mais centralizada para se conectar e encontrar informações.
Habilitar GitHub Discussions no seu repositório
Os proprietários de repositórios e pessoas com acesso de escrita podem habilitar GitHub Discussions para uma comunidade nos seus repositórios públicos e privados. A visibilidade de uma discussão é herdada do repositório no qual a discussão é criada.
Ao habilitar GitHub Discussions pela primeira vez, você será convidado a configurar um post de boas-vindas.
-
Em GitHub, acesse a página principal do repositório.
-
Abaixo do nome do repositório, clique em Configurações.
-
Role para baixo até a seção "Recursos" e clique em Configurar discussões.
-
Em "Iniciar uma nova discussão", edite o modelo para que fique alinhado aos recursos e tom que você deseja definir para sua comunidade.
-
Clique em Iniciar discussão.
Habilitar GitHub Discussions em sua organização
Os proprietários da organização podem habilitar GitHub Discussions para sua organização.
Ao habilitar as discussões da organização, você escolherá um repositório na organização para ser o repositório de origem para as discussões. Você pode usar um repositório existente ou criar um repositório especificamente para manter as discussões da sua organização. As discussões serão exibidas na página de discussões da organização e na página de discussão do repositório de origem.
A permissão para participar ou gerenciar discussões em sua organização baseia-se na permissão no repositório de origem. Por exemplo, um usuário precisa de permissão de gravação no repositório de origem para excluir uma discussão da organização. Isso é idêntico à forma como um usuário precisa de permissão de gravação em um repositório para excluir uma discussão do repositório.
Você pode alterar o repositório de origem a qualquer momento. Se você alterar o repositório de origem, as discussões não serão transferidas para o novo repositório de origem.
-
Em GitHub, acesse a página principal da sua organização.
-
No nome da sua organização, clique em Configurações.
-
Em "Discussões", selecione Habilitar discussões para esta organização.
-
Use o menu suspenso para selecionar um repositório a ser usado como repositório de origem para as discussões da sua organização.
-
Clique em Save (Salvar).
Dar as boas-vindas às contribuições para as suas discussões
Você pode dar as boas-vindas à sua comunidade e apresentar uma nova forma de se comunicar em um repositório ou organização, criando um post de boas-vindas e fixando o post na sua página de GitHub Discussions. Fixar e bloquear discussões ajuda as pessoas a saber que uma publicação é feita como um anúncio. Você pode usar os anúncios como uma forma de vincular pessoas a mais recursos e oferecer orientação para abrir discussões na sua comunidade. Para obter mais informações sobre como fixar uma discussão, confira Gerenciando discussões.
Configurar diretrizes da comunidade para colaboradores
Para discussões de repositório, você pode definir diretrizes de contribuição para incentivar os colaboradores a terem conversas significativas e úteis que sejam relevantes para o repositório. Você também pode atualizar o README do repositório para comunicar as expectativas quando os colaboradores devem abrir um problema ou discussão. Para obter mais informações sobre como fornecer diretrizes para seu projeto, confira Adicionar um código de conduta ao seu projeto e Configurar projeto para contribuições úteis.
Para discussões da organização, você pode compartilhar informações sobre como interagir com a sua organização criando um README do perfil da organização. Para saber mais, confira Personalizando o perfil da sua organização.
Criar uma nova discussão
Qualquer usuário autenticado que possa visualizar um repositório pode criar uma discussão nesse repositório. Da mesma forma, como as discussões da organização são baseadas em um repositório de origem, qualquer usuário autenticado que possa exibir o repositório de origem pode criar uma discussão nessa organização.
-
Em GitHub, navegue até a página principal do repositório ou organização na qual você deseja iniciar uma discussão.
-
No nome do repositório ou da organização, clique em Discussões.
-
No lado direito da página, clique em Nova discussão.
-
Selecione uma categoria de discussão clicando em Introdução.
-
Em "Título da discussão", digite um título para sua discussão e, em "Gravar", digite o corpo da discussão.
-
Clique em Iniciar discussão.
Criar uma nova enquete
Qualquer usuário autenticado que possa exibir um repositório pode criar uma pesquisa. Da mesma forma, como as discussões da organização são baseadas em um repositório de origem, qualquer usuário autenticado que possa exibir o repositório de origem pode criar uma enquete nessa organização.
-
Em GitHub, acesse a página principal do repositório.
-
No nome do repositório ou da organização, clique em Discussões.
-
Na lista de categorias, clique em Votações.
-
Com o botão direito, clique em Nova discussão.
-
Em "Título da discussão", digite um título e, opcionalmente, em "Gravar", digite um corpo para sua votação.
-
Em "Pergunta de votação", digite uma pergunta para sua votação.
-
Em "Opções de votação", digite pelo menos duas opções para sua votação.
-
Opcionalmente, para adicionar uma opção de sondagem extra, clique em Adicionar uma opção.
-
Clique em Iniciar votação.
Organizando discussões
Os proprietários dos repositórios e pessoas com acesso de gravação ao repositório podem criar novas categorias para manter as discussões organizadas. Da mesma forma, uma vez que as discussões da organização são baseadas em um repositório de origem, proprietários de repositório e pessoas com acesso de gravação ao repositório de origem podem criar novas categorias para discussões da organização.
Os colaboradores que participam e criam discussões podem agrupar discussões nas categorias existentes mais relevantes. As discussões também podem ser recategorizadas depois que forem criadas. Para saber mais, confira Gerenciar categorias para discussões.
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.
Promover conversas saudáveis
Pessoas com permissões de gravação para o repositório, ou para o repositório de origem para as discussões da organização, podem ajudar a supervisionar conversas importantes, colocando pontos nas discussões, excluindo discussões que não são mais úteis ou que são prejudiciais à comunidade, e transferindo as discussões para repositórios mais relevantes pertencentes à organização. Para saber mais, confira Gerenciando discussões.
Pessoas com permissões de triagem para um repositório ou para o repositório de origem das discussões da organização podem ajudar a moderar as discussões de um projeto marcando comentários como respostas, bloqueando discussões que já não são úteis ou prejudicam a comunidade e convertendo os problemas em discussões quando uma ideia ainda está nos primeiros estágios de desenvolvimento. Para saber mais, confira Moderar discussões.
Próximas etapas
Uma vez traçado um caminho claro para o definir o escopo do trabalho, deve-se concretizar a ideia. você pode criar um problema e começar a acompanhar seu progresso. Para obter mais informações sobre como criar um problema com base em uma discussão, confira Moderar discussões.