{"meta":{"title":"Comunicando-se no GitHub","intro":"Você pode discutir projetos e alterações específicas, bem como ideias mais amplas ou objetivos de equipe, usando diferentes tipos de discussões no GitHub.","product":"Introdução","breadcrumbs":[{"href":"/pt/get-started","title":"Introdução"},{"href":"/pt/get-started/using-github","title":"Usar o GitHub"},{"href":"/pt/get-started/using-github/communicating-on-github","title":"Comunicando-se no GitHub"}],"documentType":"article"},"body":"# Comunicando-se no GitHub\n\nVocê pode discutir projetos e alterações específicas, bem como ideias mais amplas ou objetivos de equipe, usando diferentes tipos de discussões no GitHub.\n\n## Introdução\n\nO GitHub fornece ferramentas de comunicação colaborativa embutidas que permitem que você interaja de perto com sua comunidade. Este guia de início rápido irá mostrar como escolher a ferramenta certa para suas necessidades.\n\nÉ possível criar problemas e participar deles, pull requests e discussões em equipe, dependendo do tipo de conversa que você deseja ter.\n\n###\n\n* São úteis para discutir detalhes específicos de um projeto como relatórios de bugs, melhorias e feedbacks planejados\n* São específicos para um repositório e geralmente têm um proprietário claro\n* Muitas vezes são referidos como o sistema de rastreamento de erros do GitHub\n\n### Solicitações de pull\n\n* Permite que você proponha alterações específicas\n* Permite que você comente diretamente as alterações propostas por outros\n* São específicos para um repositório\n\n### GitHub Discussions\n\n* São como um fórum e são mais utilizados para ideias e discussões de formato aberto em que a colaboração é importante\n* Poderá incluir muitos repositórios\n* Oferecem uma experiência colaborativa fora da base de código, permitindo o debate de ideias e a criação de uma base de informações comunitária\n* Frequentemente não têm um proprietário claro\n* Muitas vezes não resultam em uma tarefa prática.\n\n## Que ferramenta de discussão devo usar?\n\n### Cenários para problemas\n\n* Quero acompanhar as tarefas, melhorias e erros.\n* Eu quero arquivar um relatório de erro.\n* Quero partilhar o feedback sobre um recurso específico.\n* Quero fazer uma pergunta sobre os arquivos do repositório.\n\n#### Exemplo de problema\n\nEste exemplo ilustra como um usuário GitHub criou um problema em nosso repositório de documentação open source para nos informar sobre um bug e discutir uma correção.\n\n![Captura de tela de um problema, com o título \"O texto do link em azul nos avisos é ilegível porque a tela de fundo é azul\".](/assets/images/help/issues/issue-example.png)\n\n* Um usuário notou que a cor azul do banner na parte superior da página na versão em chinês da documentação do GitHub torna o texto no banner ilegível.\n* O usuário criou um problema no repositório, identificando o problema e sugerindo uma correção (que se trata de usar uma cor de fundo diferente para o banner).\n* Uma discussão se inicia e, eventualmente, será alcançado um consenso sobre a correção a ser aplicada.\n* Em seguida, um contribuidor pode criar um pull request com a correção.\n\n### Cenários para solicitações de pull\n\n* Eu quero corrigir um erro de digitação em um repositório.\n* Quero fazer alterações em um repositório.\n* Eu quero fazer alterações para consertar um problema.\n* Eu quero comentar as alterações sugeridas por outras pessoas.\n\n#### Exemplo de solicitação de pull\n\nEste exemplo ilustra como um usuário GitHub criou um pull request em nosso repositório de documentação open source para corrigir um erro de digitação.\n\nNa aba **Conversa** da solicitação de pull, o autor explica por que criou a solicitação de pull.\n\n![Captura de tela da aba \"Conversa\" de um pull request.](/assets/images/help/pull_requests/pr-conversation-example.png)\n\nA guia **Arquivos alterados** da solicitação de pull mostra a correção implementada.\n\n![Captura de tela da guia \"Arquivos alterados\" de uma solicitação de pull.](/assets/images/help/pull_requests/pr-files-changed-example.png)\n\n* Este contribuidor observa um erro de digitação no repositório.\n* O usuário cria um pull request com a correção.\n* Um mantenedor do repositório revisa o pull request, comenta sobre ele e realiza a mesclagem nele.\n\n### Cenários para GitHub Discussions\n\n* Tenho uma pergunta que não é necessariamente relacionada a arquivos específicos no repositório.\n* Eu quero compartilhar notícias com meus colaboradores ou com minha equipe.\n* Eu quero começar ou participar de uma conversa aberta.\n* Eu quero fazer um anúncio à minha comunidade.\n\n#### Exemplo de GitHub Discussions\n\nEste exemplo mostra o post de boas-vindas para o GitHub Discussions do repositório GitHub Docs open source e ilustra como a equipe deseja colaborar com a sua comunidade.\n\n![Captura de tela de um exemplo de discussão, com o título \"Bem-vindo às Discussões do GitHub Docs\".](/assets/images/help/discussions/github-discussions-example.png)\n\nEste mantenedor da comunidade iniciou uma discussão para dar as boas-vindas à comunidade e pedir aos integrantes que se apresentem. Esta postagem promove uma atmosfera de acolhedora para visitantes e contribuidores. A postagem também esclarece que a equipe tem o prazer em ajudar com as contribuições para o repositório.\n\n## Próximas etapas\n\nEstes exemplos mostraram como decidir qual é a melhor ferramenta para suas conversas no GitHub. Mas esse é apenas o começo; há muito mais que você pode fazer para adaptar essas ferramentas às suas necessidades.\n\nPara problemas, por exemplo, você pode marcar problemas com etiquetas para uma pesquisa mais rápida e criar modelos de problemas para ajudar os colaboradores a abrir problemas significativos. Para saber mais, confira [Sobre problemas](/pt/issues/tracking-your-work-with-issues/about-issues#working-with-issues) e [Sobre modelos de problema e pull request](/pt/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates).\n\nPara pull requests, você pode criar pull requests de rascunho se as suas alterações propostas ainda forem um trabalho em andamento. Não é possível fazer o merge dos pull requests de rascunho até que estejam prontos para revisão. Para saber mais, confira [Sobre solicitação de pull](/pt/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests).\n\nPara o recurso GitHub Discussions, você pode configurar um código de conduta e fixar as discussões que contenham informações importantes para sua comunidade. Para saber mais, confira [Sobre discussões](/pt/discussions/collaborating-with-your-community-using-discussions/about-discussions).\n\nPara aprender alguns recursos avançados de formatação que ajudarão você a se comunicar, confira [Guia de início rápido de gravação no GitHub](/pt/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)."}