Criar um problema

Os problemas podem ser criados de várias maneiras. Portanto, você pode escolher o método mais conveniente para seu fluxo de trabalho.

People with read access can create an issue in a repository where issues are enabled.

Os problemas podem ser usados para acompanhar erros, aprimoramentos ou outras solicitações. Para obter mais informações, consulte "Sobre problemas".

Os administradores do repositório podem desabilitar problemas para um repositório. Para obter mais informações, consulte "Desabilitar problemas".

Criar um problema a partir de um repositório

  1. No GitHub.com, navegue até a página principal do repositório.
  2. Abaixo do nome do seu repositório, clique em Problemas. Aba de problemas
  3. Clique em New issue (Novo problema). Botão New Issues (Novos problemas)
  4. Se o seu repositório usar modelos de problemas, clique em Começar ao lado do tipo de problema que você gostaria de abrir. Select the type of issue you want to create Ou, clique Abrir um problema em branco se o tipo de problema que você gostaria de abrir não estiver incluído nas opções disponíveis. Link para abrir um problema em branco
  5. Digite um título e uma descrição para o seu problema. Um exemplo de problema
  6. Se você é um mantenedor do projeto, você pode atribuir o problema a alguém, adicioná-lo a um quadro de projeto, associá-lo a um marco ou aplicar uma etiqueta.
  7. Ao terminar, clique em Enviar novo problema.

Criando um problema com GitHub CLI

GitHub CLI é uma ferramenta de código aberto para usar GitHub a partir da linha de comando do seu computador. Quando você está trabalhando na linha de comando, você pode usar GitHub CLI para economizar tempo e evitar mudar o contexto. Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

Para criar um problema, use o subcomando gh issue create. Para ignorar as instruções interativas, inclua os sinalizadores --body e --title.

gh issue create --title "My new issue" --body "Here are more details."

Você também pode especificar responsáveis, etiquetas, marcos e projetos.

gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"

Criando um problema a partir de um comentário

Você pode abrir um novo problema a partir de um comentário em um problema ou pull request. Quando você abre um problema a partir de um comentário, o problema contém um trecho mostrando onde o comentário foi originalmente publicado.

  1. Acesse o comentário que você deseja abrir a partir de um problema.
  2. No comentário, clique em .Botão de kebab no comentário de revisão de pull request
  3. Clique em Reference in new issue (Referência em um novo problema). Item de menu Reference in new issue (Referência em um novo problema)
  4. Use o menu suspenso "Repository" (Repositório) para selecionar o repositório em que deseja abrir o problema. Menu suspenso Repository (Repositório) para o novo problema
  5. Digite um título descritivo e o texto do problema. Título e texto do novo problema
  6. Clique em Create issue (Criar problema). Botão para criar novo problema
  7. Se você é um mantenedor do projeto, você pode atribuir o problema a alguém, adicioná-lo a um quadro de projeto, associá-lo a um marco ou aplicar uma etiqueta.
  8. Ao terminar, clique em Enviar novo problema.

Criando um problema a partir do código

É possível abrir um problema novo a partir de uma linha ou linhas específicas de código em um arquivo ou pull request. Quando você abre um problema de código, o problema contém um trecho mostrando a linha ou intervalo de código que você escolheu. Você pode abrir somente um problema no mesmo repositório onde o código é armazenado.

Trecho de código fornecido em um problema aberto de código

  1. No GitHub.com, navegue até a página principal do repositório.
  2. Localize o código que deseja referenciar em um problema:
    • Para abrir um problema sobre código em um arquivo, navegue até o arquivo.
    • Para abrir um problema sobre código em uma pull request, navegue até a pull request e clique em Files changed (Arquivos alterados). Depois, vá até o arquivo que contém o código que você quer incluir em seu comentário e clique em View (Visualizar).
  3. Escolha se deseja selecionar uma única linha ou um intervalo:
    • Para selecionar uma única linha de código, clique no número de linha para destacá-la. Arquivo com uma única linha de código selecionado
      • Para selecionar um intervalo de código, clique no número da primeira linha no intervalo para destacar a linha de código. Em seguida, passe o mouse sobre a última linha do intervalo de código, pressione Shift e clique no número de linha para destacar o intervalo. Arquivo com um intervalo de código selecionado
  4. À esquerda do intervalo do código, clique em . No menu suspenso, clique em Referência em um novo problema. Menu kebab com opção para abrir um novo problema a partir de uma linha selecionada
  5. Digite um título e uma descrição para o seu problema. Um exemplo de problema
  6. Se você é um mantenedor do projeto, você pode atribuir o problema a alguém, adicioná-lo a um quadro de projeto, associá-lo a um marco ou aplicar uma etiqueta.
  7. Ao terminar, clique em Enviar novo problema.

Criando um problema da discussão

As pessoas com permissão de triagem para um repositório podem criar um problema a partir de uma discussão.

Ao criar um problema a partir de uma discussão, o conteúdo da postagem na discussão será automaticamente incluído no texto do problema e todas as etiquetas serão mantidas. A criação de um problema a partir de uma discussão não converte a discussão em um problema ou exclui a discussão existente. Para obter mais informações sobre GitHub Discussions, consulte "Sobre discussões "".

  1. No nome do seu repositório, clique em Discussões. Aba "Discussões" de um repositório
  2. Na lista de discussões, clique na discussão que você deseja visualizar. Discussão na lista de discussões de um repositório
  3. Na barra lateral direita, clique em Criar problema a partir da discussão. Botão para criar um problema da discussão
  4. Digite um título e uma descrição para o seu problema. Um exemplo de problema
  5. Se você é um mantenedor do projeto, você pode atribuir o problema a alguém, adicioná-lo a um quadro de projeto, associá-lo a um marco ou aplicar uma etiqueta.
  6. Ao terminar, clique em Enviar novo problema.

Criando um problema a partir de uma observação do quadro de projeto

Se estiver usando um quadro de projeto para rastrear e priorizar seu trabalho, você poderá converter observações do quadro de projeto em problemas. Para obter mais informações, consulte "Sobre quadros de projeto" e "Adicionando observações a um quadro de projeto".

Criando uma problema a partir de um item da lista de tarefas

Dentro de um problema, você pode usar as listas de tarefas para dividir o trabalho em tarefas menores e acompanhar o conjunto completo de trabalho a ser concluído. Se uma tarefa exigir mais rastreamento ou discussão, você poderá convertê-la em um problema, passando o mouse sobre a tarefa e clicando em no canto superior direito da tarefa. Para obter mais informações, consulte "Sobre listas de tarefas".

Criando um problema a partir de uma consulta de URL

Você pode usar parâmetros de consulta para abrir problemas. Os parâmetros de consulta são partes opcionais de uma URL que podem ser personalizadas para compartilhar uma exibição de página web específica, como resultados do filtro de pesquisa ou um modelo de problemas no GitHub. Para criar seus próprios parâmetros de consulta, você deve corresponder o par de chave e valor.

Dica: também é possível criar modelos de problemas que são abertos com etiquetas padrão, responsáveis e um título para o problema. Para obter mais informações, consulte "Usar modelos para incentivar problemas úteis e pull requests".

Você deve ter as permissões adequadas para qualquer ação para usar o parâmetro de consulta equivalente. Por exemplo, é preciso ter permissão para adicionar uma etiqueta a um problema para usar o parâmetro de consulta label. For more information, see "Repository roles for an organization."

Se você criar uma URL inválida usando parâmetros de consulta, ou se você não tiver as permissões adequadas, a URL retornará uma página de erro 404 Not Found. Se você criar uma URL que excede o limite do servidor, a URL retornará uma página de erro de 414 URI Too Long.

Parâmetro de consultaExemplo
titlehttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report cria um problema com a etiqueta "erro" e o título "Novo relatório de erros".
textohttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. cria um problema com o título "Novo relatório de erro" e o comentário "Descreva o problema" no texto do problema.
etiquetashttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug cria um problema com as etiquetas "help wanted" e "bug".
marcohttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones cria um problema com o marco "marcos de teste".
assigneeshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat cria um problema e o atribui a @octocat.
projetoshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 cria um problema com o título "Correção de erro" e o adiciona ao quadro de projeto 1 da organização.
modelohttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md cria um problema com um modelo no texto do problema. O parâmetro de consulta template funciona com modelos armazenados em um subdiretório ISSUE_TEMPLATE dentro da raiz, docs/ ou diretório do .github/ em um repositório. Para obter mais informações, consulte "Usar modelos para incentivar problemas úteis e pull requests".

Creating an issue from a Varredura de código alert

Note: The tracking of Varredura de código alerts in issues is in beta and subject to change.

This feature supports running analysis natively using GitHub Actions or externally using existing CI/CD infrastructure, as well as third-party Varredura de código tools, but not third-party tracking tools.

If you're using issues to track and prioritize your work, you can use issues to track Varredura de código alerts.

For more information about creating issues to track Varredura de código alerts, see "Tracking Varredura de código alerts in issues using task lists."

Leia mais

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.