Página da Issue
Last updated
Was this helpful?
Last updated
Was this helpful?
Agora que você criou sua primeira issue, vamos explorar os principais componentes da página de exibição e entender como interagir com eles. Abaixo, abordamos as seções mais importantes da interface para que você possa navegar de maneira mais eficiente.
A seção de Cabeçalho contém as informações essenciais sobre a issue, fornecendo uma visão geral rápida e permitindo interações básicas com a issue.
Título da Issue: Exibe o nome ou título da issue, que normalmente resume o problema ou a tarefa a ser resolvida. Neste caso: Adicionar imagem de saudação ao README.md.
Número da Issue: Aparece ao lado do título, indicando o número único da issue dentro do repositório. Neste caso: #1.
Status da Issue: Indica se a issue está aberta (open) ou fechada (closed). Neste caso: Open .
Botão Edit: Permite editar a descrição da issue, caso seja necessário atualizar ou corrigir informações.
Botão New Issue: Usado para criar uma nova issue no repositório.
Botão de Cópia: Permite copiar o link da issue para compartilhá-lo facilmente com outras pessoas.
A seção de Descrição contém as informações detalhadas sobre a issue e serve como o ponto de partida para a discussão e a resolução do problema.
Última Atividade na Issue: Esta seção mostra a última ação realizada na issue, quem a realizou e quando aconteceu. A atividade pode ser uma atualização no texto, uma mudança de status, ou qualquer outra ação relevante.
Texto da Issue: O corpo da issue onde o problema é descrito detalhadamente. Pode incluir texto formatado com Markdown, links, imagens e outras anotações para explicar o contexto da issue.
Botão Create sub-issue: Permite criar uma sub-issue relacionada à issue principal, facilitando o gerenciamento de tarefas dependentes.
Botão de reagir à issue: Pessoas usuárias podem adicionar reações em forma de emojis (👍, 👎, 😄, etc.) como forma de engajamento.
Esta seção registra todas as atividades realizadas na issue, como quando ela foi aberta, fechada, ou reaberta, quem fez essas alterações e as respectivas datas. Esse histórico ajuda a acompanhar o progresso e as interações na issue.
Para a sua issue recém criada, não haverá ainda ações, mas no futuro elas se pareceram algo como:
Registro de Ação: Exibe uma linha do tempo das atividades realizadas, como quando a issue foi aberta, fechada, ou reaberta. Cada ação inclui o nome da pessoa usuária que realizou a mudança e a data/hora correspondente.
A seção de comentários é onde a discussão sobre a issue acontece. Aqui, pessoas colaboradoras podem compartilhar suas opiniões, sugestões ou atualizações sobre o progresso da resolução.
Comentários: Exibe todos os comentários feitos pelas pessoas participantes. Eles ajudam a registrar decisões, discussões e atualizações sobre a issue.
Botões de Reação: Permitem que as pessoas usuárias reajam aos comentários com emojis (como 👍, 👎, 😄, etc.).
Editor de Comentários: Campo para adicionar novos comentários, onde os usuários podem digitar suas mensagens e usar o Markdown para formatação. Também inclui botões para anexar arquivos ou mencionar outros usuários com @username.
Quando uma issue é resolvida ou considerada concluída, a pessoa responsável pode fechá-la. Existem várias opções de fechamento que oferecem contexto adicional sobre o status da issue.
Close as Complete: Indica que a issue foi concluída com sucesso.
Close as Not Planned: Marca a issue como algo que não será planejado ou trabalhado no momento.
Close as Duplicated: Usado quando a issue é considerada duplicada de outra já existente.
Essas opções de fechamento ficam localizadas na seção de comentários para que o responsável pela issue forneça uma explicação sobre o motivo do fechamento. Essa explicação é importante para garantir clareza na comunicação e evitar confusões, especialmente quando outras pessoas estão acompanhando a issue.
Não vamos falar de todas as opções, apenas as mais importantes para agora.
Assignees: Lista as pessoas responsáveis pela resolução da issue. Ao clicar no ícone de engrenagem, você consegue atribuir ou desatribuir pessoas da issue e isso é refletido instantaneamente na barra lateral. Iremos falar mais sobre o assunto atribuição nas próximas seções.
Labels: Tags visuais que ajudam a categorizar a issue. As labels são configuráveis e podem ser usadas para identificar o tipo da issue (por exemplo, "bug", "enhancement", "help wanted"). Ao clicar no ícone de engrenagem, você consegue adicionar ou remover labels da issue e isso é refletido instantaneamente na barra lateral. Iremos falar mais sobre o assunto labels nas próximas seções.
Notifications: Aqui você pode configurar as notificações relacionadas à issue, como quem será notificado sobre atividades na issue. As ações feitas nas notificações, como alterar preferências, são refletidas na barra lateral.
Links para Issues Relacionadas e Pull Requests: Outras issues relacionadas ou Pull Requests podem ser mencionadas ou vinculadas diretamente, ajudando a organizar a discussão entre várias issues. Iremos falar mais sobre o assunto pull request mais adiante.
Participants: Exibe todos as pessoas usuárias que participaram da issue de alguma forma (comentando, reacionando, etc.). A participação de novas pessoas ou mudanças nas ações de participantes são atualizadas na barra lateral em tempo real.
Delete Issue: Permite a exclusão da issue, caso seja necessário. Este botão só está disponível para os administradores do repositório.
Notas:
Mencionar Usuários: Mencionar usuários com @username no corpo da issue ou nos comentários notifica os usuários mencionados, permitindo fácil colaboração e engajamento.
Notificação de Fechamento: Quando a issue é fechada ou reaberta, todos os envolvidos na issue recebem notificações, dependendo de suas configurações de notificação.
A seguir, vamos explorar o conceito de atribuição de issues.
