8.4 Atribuindo uma Issue no GitHub

No GitHub, a atribuição de issues é uma forma de indicar que uma ou mais pessoas estão trabalhando em uma tarefa específica dentro de um repositório. Isso ajuda a organizar as contribuições, evitando esforços duplicados e garantindo que as tarefas sejam concluídas de maneira eficiente.

Como funciona a atribuição de issues?

• Somente pessoas com permissão de Triage, Write ou Admin no repositório podem atribuir issues a si mesmas ou a outros.

• Para que alguém possa ser atribuído a uma issue, essa pessoa precisa ter interagido com a issue (como comentando) ou ser um membro da organização ou repositório.

• Uma issue atribuída indica que a pessoa ou as pessoas responsáveis estão ativamente trabalhando nela.

• Normalmente, a atribuição é feita para evitar que muitas pessoas trabalhem na mesma issue sem coordenação.

• Se uma pessoa não puder mais trabalhar na issue, ela deve remover sua atribuição para que outra pessoa possa assumi-la.

Como atribuir uma pessoa a uma issue?

Se você possui permissão para atribuir issues, siga este passo a passo para adicionar uma pessoa a uma issue no GitHub:

Atribuir a si mesmo

1. Acesse a issue: Vá até a issue que deseja atribuir.

2. Localize a seção "Assignees": No lado direito da tela, encontre a seção chamada "Assignees".

3. Clique em "Assign yourself" se quiser se atribuir automaticamente

Atribuir a outras pessoas

1. Acesse a issue: Vá até a issue que deseja atribuir.

2. Localize a seção "Assignees": No lado direito da tela, encontre a seção chamada "Assignees".

3. Clique no ícone de engrenagem
4. Escolha o(s) nome(s) da(s) pessoa(s) na lista de usuários disponíveis.

5. Confirme a atribuição: cada pessoa selecionada será adicionada como responsável pela issue.

Se a pessoa que deseja atribuição não aparece na lista, isso pode ocorrer porque ela ainda não interagiu com a issue ou não tem permissão no repositório.

Como pedir atribuição de uma issue?

Se você deseja trabalhar em uma issue, mas não tem permissão para se atribuir diretamente, siga estes passos:

1. Comente na issue: Deixe um comentário na issue informando que gostaria de trabalhar nela. Isso é essencial, pois o GitHub só permite que mantenedores atribuam issues para pessoas que já interagiram na discussão. Exemplo:

   Olá! Posso trabalhar nessa issue?

2. Aguarde a resposta de um mantenedor: Um mantenedor ou colaborador do repositório pode responder confirmando e atribuindo a issue a você.

3. Interaja com a equipe: Se houver dúvidas sobre a issue, pergunte nos comentários antes de começar. Isso pode incluir pedir mais detalhes sobre o que precisa ser feito ou confirmar se sua abordagem está correta.

4. Verifique as diretrizes do repositório: Alguns projetos têm regras específicas sobre a atribuição de issues, como um tempo limite para concluir a tarefa antes de liberar a issue para outra pessoa.

Boas práticas ao assumir uma issue

• Leia atentamente a descrição da issue e os comentários anteriores para entender o contexto.

• Se precisar de mais informações, pergunte antes de começar.

• Se perceber que não pode mais trabalhar na issue, avise para que outra pessoa possa assumi-la.

• Sempre mantenha a comunicação aberta com a equipe do projeto.

• Use os comentários para atualizar o status do seu progresso, compartilhar dificuldades e alinhar expectativas com os mantenedores.

Sua vez!

Agora vamos colocar esse conhecimento em prática:

1. Acesse a issue "Adicionar imagem de saudação ao README.md" que você criou anteriormente.

2. Como o repositório é seu, você tem permissão para se atribuir diretamente.

3. No lado direito da issue, localize a seção "Assignees".
4. Clique em "Assign yourself".

Pronto! Agora você está oficialmente responsável por trabalhar nessa issue.

---

Parece um ritual meio exagerado, certo? Já que você está basicamente falando sozinho e ninguém mais está interagindo com o seu repositório. Mas pense nisso como um ensaio para quando for contribuir em projetos com outras pessoas.

Seguindo essas orientações, você contribuirá de forma mais eficiente para projetos colaborativos.