Diário de Bordo - Alexandre Lema Junior
Informações da Sprint
| Item | Descrição |
|---|---|
| Sprint | Sprint 1 |
| Data de Início | 21/04/2026 |
| Data de Término | 13/05/2026 |
| Responsável | Alexandre Junior |
Resumo da Sprint
Durante esta sprint, o foco esteve na transição da fase exploratória para a fase de contribuição efetiva. As atividades incluíram aprofundamento na leitura da documentação existente do projeto, análise mais criteriosa do repositório de issues no GitHub e definição de uma estratégia de contribuição alinhada ao perfil não-código (documentação ou UX/UI). A sprint evidenciou a complexidade de entrar em um projeto maduro como contribuidor externo, exigindo mais tempo de pesquisa e triagem do que o inicialmente planejado. A ausência do representante do Tainacan em reunião previamente agendada também impactou o andamento da sprint.
Atividades Realizadas
| Atividade | Tipo | Referência | Status |
|---|---|---|---|
| Leitura aprofundada da documentação do tainacan-wiki | Estudo | github.com/tainacan/tainacan-wiki | Concluído |
| Análise das issues abertas no repositório principal | Análise | github.com/tainacan/tainacan/issues | Concluído |
| Triagem de issues por tipo (documentação, UX/UI, bug) | Análise | GitHub Issues | Concluído |
| Estudo do processo de contribuição do projeto | Estudo | Contribution Guidelines | Concluído |
| Análise da estrutura do tainacan-wiki como repositório separado | Estudo | github.com/tainacan/tainacan-wiki | Concluído |
| Identificação de lacunas e possíveis contribuições não-código | Análise | Documentação e issues | Em andamento |
Maiores Avanços
Compreensão do fluxo de contribuição:
Foi identificado que o Tainacan aceita contribuições em múltiplos repositórios — o repositório principal (tainacan/tainacan) para código, e o tainacan/tainacan-wiki especificamente para documentação. Isso abre uma via clara de contribuição sem envolver alterações no código-fonte.
Mapeamento das labels de issues:
O repositório principal utiliza um sistema de labels bem estruturado, incluindo [Type] Enhancement, [Type] Bug, [Effort] Level 1/2/3... e labels por módulo ([Module] Admin, [Module] Gutenberg, etc.). Esse mapeamento facilita a identificação de issues mais acessíveis para contribuidores iniciantes.
Identificação de oportunidade na documentação: A versão 1.0.0 do Tainacan introduziu mudanças significativas na interface administrativa (breaking changes in the Admin side), mas a documentação correspondente ainda está pendente — os próprios releases mencionam que a documentação atualizada está por vir. Isso representa uma oportunidade concreta de contribuição.
Maiores Dificuldades
Volume de issues e falta de label "good first issue":
Diferente de muitos projetos open source, o Tainacan não utiliza a label good first issue, o que torna a triagem mais trabalhosa para contribuidores externos.
Ausência do representante do Tainacan na reunião agendada: O grupo havia agendado uma reunião com um representante do projeto Tainacan com o objetivo de alinhar expectativas, entender melhor as prioridades da comunidade e identificar issues adequadas para contribuição. O representante não compareceu, o que impactou diretamente o andamento da sprint, sem esse direcionamento, o processo de triagem de issues precisou ser feito de forma totalmente autônoma, consumindo mais tempo e gerando mais incerteza sobre qual caminho de contribuição seria mais bem-vindo pela comunidade.
Definir uma contribuição viável no prazo da disciplina: Issues de UX/UI frequentemente envolvem discussão com os mantenedores antes de qualquer implementação, e issues de documentação exigem domínio do sistema antes de escrever com precisão.
Aprendizados
Estrutura de contribuição em projetos maduros: Projetos como o Tainacan possuem processos e convenções estabelecidas. Entender o fluxo de issues, pull requests e a separação entre repositórios (código vs. wiki) é parte essencial da contribuição.
Documentação como contribuição de primeira classe:
O repositório tainacan-wiki é um projeto independente com seu próprio histórico de commits e issues, o que confirma que contribuições de documentação têm o mesmo peso e processo que contribuições de código.
Imprevistos em comunidades open source: A não comparência do representante evidenciou que, em projetos open source reais, a comunicação com mantenedores nem sempre flui como esperado. Saber contornar isso de forma proativa — buscando canais alternativos como fóruns e GitHub Discussions — faz parte da experiência de contribuição.
Plano Pessoal para a Próxima Sprint
- Escolher e comentar em uma issue (ou abrir uma nova) no repositório adequado
- Priorizar issues relacionadas à documentação e UX/UI, alinhadas ao perfil de contribuição não-código do grupo
- Tentar reagendar contato com o representante do Tainacan ou buscar outros canais da comunidade (fórum oficial, GitHub Discussions) para suprir a falta de orientação direta
- Interagir com a comunidade na própria issue escolhida
- Registrar o processo de escolha da contribuição no próximo diário
Histórico de Versões
| Versão | Data | Descrição | Autor(es) |
|---|---|---|---|
1.0 |
27/05/2026 | Criação do Diário de bordo da Sprint 1 | Alexandre Junior |
2.0 |
01/07/2026 | Adicionando tabela de datas | Alexandre Junior |