{"meta":{"title":"Início rápido para problemas no GitHub","intro":"Siga este breve guia interativo para saber mais sobre GitHub Issues.","product":"GitHub Issues","breadcrumbs":[{"href":"/pt/enterprise-server@3.18/issues","title":"GitHub Issues"},{"href":"/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues","title":"Problemas"},{"href":"/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/learning-about-issues","title":"Aprender sobre problemas"},{"href":"/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/learning-about-issues/quickstart","title":"Início rápido para problemas no GitHub"}],"documentType":"article"},"body":"# Início rápido para problemas no GitHub\n\nSiga este breve guia interativo para saber mais sobre GitHub Issues.\n\n## Introdução\n\nEste guia demonstra como usar GitHub Issues para planejar e acompanhar um trabalho. Neste guia, você criará um novo item e o dividirá em subitens. Você também aprenderá a adicionar rótulos, tipos de problemas, marcos, atribuições e projetos para comunicar metadados sobre seu problema.\n\n## Pré-requisitos\n\nPara criar um problema, você precisa de um repositório. Você pode usar um repositório existente ao qual você tem acesso de gravação ou criar um novo repositório.\nO repositório deve ter a opção de resolução de problemas ativada. Para obter mais informações sobre como criar um repositório, consulte [Criar um repositório](/pt/enterprise-server@3.18/repositories/creating-and-managing-repositories/creating-a-new-repository). Para mais informações sobre como habilitar os problemas se eles estiverem desabilitados no seu repositório, consulte [Desabilitar problemas](/pt/enterprise-server@3.18/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues).\n\n## Abrir um problema em branco\n\nPrimeiro, crie um problema. Existem várias maneiras de criar um problema. Você pode escolher o método mais conveniente para seu fluxo de trabalho. Este exemplo usará a UI GitHub. Para mais informações sobre outras maneiras de criar um problema, consulte [Criar um problema](/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/using-issues/creating-an-issue).\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do seu repositório, clique em **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-issue-opened\" aria-label=\"issue-opened\" role=\"img\"><path d=\"M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path><path d=\"M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z\"></path></svg> Issues**.\n\n   ![Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como \"Problemas\", é destacada em laranja escuro.](/assets/images/help/repository/repo-tabs-issues-global-nav-update.png)\n3. Clique em **Novo problema**.\n4. Neste exemplo, começaremos com um item em branco. Seu repositório pode usar modelos de issues para incentivar os colaboradores a incluir informações específicas. Se o repositório usar modelos de problema, clique em **Abrir um problema em branco**.\n\n## Preenchimento de informações\n\nDê um título descritivo ao seu problema. O título deverá transmitir resumidamente o problema.\n\nAdicione uma descrição que explique o propósito do problema, incluindo todos os detalhes que possam ajudar a resolvê-lo. Por exemplo, se este for um relatório de erro, descreva as etapas para reproduzir o erro, o resultado esperado e o resultado real.\n\nVocê pode usar o markdown para adicionar formatação, links, emojis e muito mais. Para saber mais, confira [Como escrever no GitHub](/pt/enterprise-server@3.18/get-started/writing-on-github).\n\n![Captura de tela do formulário de um novo problema, com o título e o corpo preenchidos.](/assets/images/help/issues/issue-title-body.png)\n\n## Adicionando uma lista de tarefas\n\nVocê também pode usar texto simples para acompanhar as tarefas que não têm um problema correspondente e convertê-las em problemas posteriormente. Para saber mais, confira [Sobre as listas de tarefas](/pt/enterprise-server@3.18/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists).\n\n![Captura de tela do formulário de um novo problema, com o título e o corpo preenchidos. O corpo inclui o Markdown de uma lista de tarefas.](/assets/images/help/issues/issue-task-list-raw.png)\n\n## Atribuindo a tarefa\n\nPara comunicar responsabilidade, você pode atribuir a questão a um integrante da sua organização. Confira [Atribuindo problemas e solicitações de pull a outros usuários GitHub](/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users).\n\n![Captura de tela do formulário de nova solicitação. Na barra lateral direita, há uma seção \"Destinatários\" com o contorno em laranja escuro.](/assets/images/help/issues/issue-assignees.png)\n\n## Adicionando etiquetas\n\nAdicione uma etiqueta para categorizar o seu problema. Por exemplo, você pode usar um rótulo `question` e um rótulo `good first issue` para indicar que um problema é uma questão que um colaborador que está contribuindo pela primeira vez pode detectar. Os usuários podem filtrar problemas por etiqueta para encontrar todos os problemas com uma etiqueta específica.\n\nVocê pode usar as etiquetas padrão ou criar uma nova. Para saber mais, confira [Gerenciar etiquetas](/pt/enterprise-server@3.18/issues/using-labels-and-milestones-to-track-work/managing-labels).\n\n![Captura de tela do formulário de nova solicitação. Na barra lateral direita, há uma seção \"Rótulos\" com o contorno em laranja escuro.](/assets/images/help/issues/issue-with-label.png)\n\n## Como adicionar tipos de problema\n\nVocê pode adicionar um tipo de problema para classificar o trabalho em toda a organização. Confira [Como gerenciar tipos de problemas em uma organização](/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization).\n\n![Captura de tela do formulário de nova solicitação. Na barra lateral direita, há uma seção \"Tipo\" com o contorno em laranja escuro.](/assets/images/help/issues/issue-type.png)\n\n## Adicionando o problema a um projeto\n\nVocê pode adicionar o problema a um projeto existente e preencher metadados para o projeto. Para obter mais informações sobre projetos, confira [Sobre o Projects](/pt/enterprise-server@3.18/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects).\n\n![Captura de tela do formulário de nova solicitação. Na barra lateral direita, há uma seção \"Projetos\" com o contorno em laranja escuro.](/assets/images/help/issues/issue-project.png)\n\n## Adicionar marcos\n\nVocê pode adicionar um marco para acompanhar o problema como parte de um destino baseado em data. Um marco mostra o progresso das questões à medida que se aproxima a data-alvo. Confira [Sobre marcos](/pt/enterprise-server@3.18/issues/using-labels-and-milestones-to-track-work/about-milestones).\n\n![Captura de tela do formulário de nova solicitação. Na barra lateral direita, há uma seção \"Marco\" com o contorno em laranja escuro.](/assets/images/help/issues/issue-milestone.png)\n\n## Enviando o seu problema\n\nClique em **Enviar novo problema** para criar seu problema. Você pode editar qualquer um dos campos acima após a criação do problema. Seu problema tem uma URL única que você pode compartilhar com os integrantes da equipe ou fazer referência a outros problemas ou pull requests.\n\n## Como adicionar subproblemas\n\nVocê pode adicionar subproblemas a um problema para dividir rapidamente partes maiores do trabalho em problemas menores. Os subproblemas adicionam suporte para hierarquias de problemas no GitHub com a criação de relacionamentos entre os problemas. Você pode criar vários níveis de subproblemas que representam com precisão seu projeto, dividindo com exatidão as tarefas no nível de detalhe que você e sua equipe precisam. Consulte [Como adicionar subproblemas](/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues) e [Navegando em subproblemas](/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues).\n\n![Captura de tela da seção de subproblemas abaixo da descrição do problema. O botão \"Mostrar mais opções de subproblemas\" é realçado com um retângulo laranja.](/assets/images/help/issues/sub-issue-drop-down.png)\n\n## Como adicionar dependências de problema\n\nVocê pode definir relações de bloqueio entre problemas usando dependências de problemas. As dependências de problemas permitem identificar problemas bloqueados por, ou que estão bloqueando, outros trabalhos. Confira [Como criar dependências de problema](/pt/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies).\n\n## Comunicar\n\nDepois que o seu problema for criado, continue a conversa adicionando comentários ao problema. Você pode @mention colaboradores ou equipes para chamar a atenção deles para um comentário. Para vincular problemas relacionados no mesmo repositório, digite `#` seguido de uma parte do título do problema e clique no problema que deseja vincular. Para saber mais, confira [Como escrever no GitHub](/pt/enterprise-server@3.18/get-started/writing-on-github).\n\n![Captura de tela de um comentário de questão. O cabeçalho diz \"octocat comentou agora\" e o corpo diz \"@hubot Precisamos também atualizar a lógica do foguete?\"](/assets/images/help/issues/issue-comment.png)\n\n## Próximas etapas\n\nVocê pode usar questões para uma grande variedade de finalidades. Por exemplo:\n\n* Rastrear ideias\n* Recolhendo feedback\n* Planejar tarefas\n* Como relatar bugs\n\nPara dividir seu problema em tarefas mais gerenciáveis, você pode adicionar vários níveis de subproblemas. Confira [Como adicionar subproblemas](/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues).\n\nAqui estão alguns recursos úteis para executar suas próximas etapas com GitHub Issues:\n\n* Para saber mais sobre os problemas, confira [Sobre problemas](/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/learning-about-issues/about-issues).\n* Para conhecer as noções básicas para usar as ferramentas de planejamento e acompanhamento do GitHub, consulte [Planejamento e rastreamento de trabalho para a sua equipe ou projeto](/pt/enterprise-server@3.18/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project).\n* Para saber mais sobre como os projetos podem ajudar você com o planejamento e o acompanhamento, confira [Mais informações sobre Projects](/pt/enterprise-server@3.18/issues/planning-and-tracking-with-projects/learning-about-projects).\n* Para saber mais sobre como usar modelos de issue para incentivar contribuidores a fornecer informações específicas, consulte [Usando modelos para incentivar problemas úteis e receber pull request](/pt/enterprise-server@3.18/communities/using-templates-to-encourage-useful-issues-and-pull-requests)."}