> For the complete documentation index, see [llms.txt](https://cumbucadev.gitbook.io/github-essentials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cumbucadev.gitbook.io/github-essentials/dia-8/explorando-a-pagina-de-uma-issue-no-github.md).

# Explorando a Página de uma Issue no GitHub

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.

<figure><img src="/files/QHJ96OStDgblYHJc16vT" alt=""><figcaption><p>Issue <a href="https://github.com/aprendizCumbucaDev/hello-world/issues/1">https://github.com/aprendizCumbucaDev/hello-world/issues/1</a></p></figcaption></figure>

## **Cabeçalho**

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.

<figure><img src="/files/gOPHOkPVYxSavC6jRjfN" alt=""><figcaption><p>Cabeçalho da issue <a href="https://github.com/aprendizCumbucaDev/hello-world/issues/1">https://github.com/aprendizCumbucaDev/hello-world/issues/1</a></p></figcaption></figure>

* **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`.
* **Estado da Issue**: Indica se a issue está aberta (open) ou fechada (closed). Neste caso: `Open` .
* **Botão Edit**: Permite editar o título 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.

## Descrição

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.

<figure><img src="/files/rfbIqeYln7zcBAq4KXJN" alt=""><figcaption><p>Descrição da issue <a href="https://github.com/aprendizCumbucaDev/hello-world/issues/1">https://github.com/aprendizCumbucaDev/hello-world/issues/1</a></p></figcaption></figure>

* **Ú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.\
  Neste caso: aprendizCumbucaDev opened 17 minutes ago (aprendizCumbucaDev abriu 17 minutos atrás)
* **Botão `...`(Mais Opções)**: Disponibiliza ações adicionais. Entre as principais: Copy Link (Copiar Link) e Edit (Editar).&#x20;
  * ![](/files/tfSay5ExpB9BTJAAZN1K)
  * **Copy Link:** Permite copiar o link para a issue para compartilhá-la facilmente.
  * **Edit:** Permite editar a descrição da issue.
* **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.

## **Histórico de Ações**

Esta seção registra todas as atividades da issue, como sua abertura, fechamento, reabertura, adição de comentários e labels, entre outras. Também exibe quem realizou cada ação e quando. Esse histórico permite acompanhar o progresso e todas as interações ao longo do tempo.

Como a sua issue foi recém criada, não haverá ainda muitas ações, mas no futuro o histórico de ações se parecerá algo como:

<figure><img src="/files/D4b3DGvx9FFA598c6ikt" alt=""><figcaption></figcaption></figure>

* **Registro de Ação**: Exibida na linha do tempo das atividades realizadas. Cada ação inclui o nome da pessoa usuária que realizou a mudança e a data/hora correspondente.

## Seção de Criação e Edição de Comentários

A seção de criação e edição de comentários é onde você pode escrever e enviar mensagens para participar das discussões em uma issue. Nela, é possível contribuir com sugestões, esclarecer dúvidas, fornecer atualizações ou interagir com outras pessoas colaboradoras. Além disso, o editor oferece suporte a Markdown para formatação, permite anexar arquivos e mencionar usuários com `@username`, facilitando a comunicação e a colaboração.

<figure><img src="/files/mQDJbdiOT9fRAjgRplFY" alt=""><figcaption></figcaption></figure>

* **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`.

Escreve seu comentário e clique em **Comment** para publicá-lo. Após a publicação, o comentário fica registrado no histórico de atividades.

<figure><img src="/files/P9z56pVJIa9wRJ1bhQYq" alt=""><figcaption><p>Seção de comentários da issue <a href="https://github.com/aprendizCumbucaDev/hello-world/issues/1">https://github.com/aprendizCumbucaDev/hello-world/issues/1</a></p></figcaption></figure>

Clique no botão **Mais Ações** (`...`) para:

* **Copiar link de compartilhamento** (*Copy Link*).
* **Editar o comentário** (*Edit*).
* **Excluir o comentário** (*Delete*).

<figure><img src="/files/46GWfXyk2YuMGXH1TBso" alt="" width="375"><figcaption></figcaption></figure>

Utilize o **Botão de Reações** para reagir aos comentários que aparecem no histórico de atividades com emojis.

<figure><img src="/files/iXPPdjYwZl9NyRCuQzPh" alt="" width="354"><figcaption></figcaption></figure>

### Botão de Fechamento

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.

<figure><img src="/files/FRrvPdTWvEgPwQt7U9TA" alt=""><figcaption><p>Opções de fechamento ao clicar na seta do botão "Close issue"</p></figcaption></figure>

* **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.

## Barra Lateral

Nesta seção, apresentamos as opções mais importantes da barra lateral para gerenciar uma issue.

<figure><img src="/files/XQjd5p5klcRVvmAwK5B9" alt=""><figcaption></figcaption></figure>

* **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**: Etiquetas 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 que você receberá relacionadas à 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 Contas Usuárias**: Mencionar contas usuárias com `@conta` 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cumbucadev.gitbook.io/github-essentials/dia-8/explorando-a-pagina-de-uma-issue-no-github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.