Diário de Bordo – Sprint 1

Identificação

Campo	Informação
Sprint	1
Responsável	Hauedy Wegener
Disciplina	GCES

Objetivo da Sprint

O foco desta sprint foi a transição da fase de estudo para a busca efetiva por um caminho de contribuição. Meu objetivo pessoal foi entender melhor como o Tainacan recebe contribuições, analisar as issues abertas no repositório oficial e identificar em que ponto do projeto eu poderia atuar dentro do meu perfil (documentação e acompanhamento do processo).

Atividades Realizadas

Atividade	Tipo	Status
Leitura aprofundada da documentação e do `tainacan-wiki`	Estudo	Concluído
Análise das issues abertas no repositório principal	Análise	Concluído
Triagem das issues por tipo (documentação, bug, enhancement)	Análise	Concluído
Estudo do sistema de labels do projeto	Estudo	Concluído
Acompanhamento da tentativa de contato do grupo com os mantenedores	Comunicação	Realizada, sem resposta

Ferramentas e Tecnologias Utilizadas

Ferramenta / Tecnologia	Finalidade
GitHub (Issues)	Análise e triagem das issues abertas
GitHub (`tainacan-wiki`)	Estudo do repositório de documentação
VS Code	Anotação e organização do que foi levantado

Atividades Realizadas em Detalhes

1. Análise do fluxo de contribuição

Aprofundei o entendimento de que o Tainacan aceita contribuições em mais de um repositório: o principal (tainacan/tainacan), voltado ao código, e o tainacan-wiki, específico para documentação. Isso deixou claro que existe um caminho de contribuição alinhado ao meu perfil, sem necessariamente alterar o código-fonte do plugin.

2. Triagem das issues e estudo das labels

Percorri as issues abertas do repositório principal e observei que o projeto usa um sistema de labels bem estruturado ([Type] Enhancement, [Type] Bug, [Effort] Level 1/2/3, [Module] ...). Notei também que o Tainacan não utiliza a label good first issue, o que torna a triagem mais trabalhosa para quem está entrando no projeto. Fiz um mapeamento das issues que pareciam mais acessíveis para acompanhar a evolução delas nas próximas sprints.

3. Tentativa de contato com o projeto

O grupo tentou estabelecer contato com os responsáveis pelo Tainacan para esclarecer dúvidas sobre as issues e as prioridades da comunidade, mas não obtivemos resposta nesta sprint. Acompanhei essa tentativa e, diante da ausência de retorno, o grupo precisou avançar de forma mais autônoma, apoiando-se na documentação e no histórico do repositório.

Dificuldades Encontradas

Volume grande de issues e ausência da label good first issue, o que dificultou identificar tarefas adequadas para iniciantes.
Falta de retorno na tentativa de contato com os mantenedores, o que gerou incerteza sobre qual caminho de contribuição seria mais bem recebido.
Definir uma forma de contribuição viável dentro do prazo da disciplina, já que issues de documentação exigem bom domínio do sistema antes de escrever com precisão.

Aprendizados

Projetos open-source maduros têm processos e convenções próprios; entender o fluxo de issues, PRs e a separação entre repositórios (código e wiki) é parte essencial de contribuir.
Documentação é uma contribuição de primeira classe: o tainacan-wiki é um repositório independente, com seu próprio histórico, o que confirma que contribuições de documentação têm o mesmo peso das de código.
Em comunidades open-source, a comunicação com os mantenedores nem sempre flui como esperado, e é preciso saber avançar de forma autônoma buscando informação em diferentes fontes.

Próximos Passos

Acompanhar a reunião de alinhamento com os mantenedores para reduzir as incertezas sobre o caminho de contribuição.
Continuar acompanhando as issues mapeadas e a decisão do grupo sobre a demanda a ser explorada.
Aprofundar o entendimento da parte de documentação do projeto, alinhada ao meu perfil de atuação.

Histórico de Versões

Versão	Data	Descrição	Autor
1.0	27/05/2026	Criação do diário de bordo da Sprint 1	Hauedy Wegener