Terceiro fim de semana de Preptember 2025: Cores e IA no GitFichas
O final de semana três de Preptember chegou, mas este foi um pouco diferente dos finais de semana anteriores… Este fim de semana foi cheio de preparação para o Oktane já que vou apresentar um workshop por lá além de ajudar no estande da Auth0, então meu tempo foi mais limitado que o normal. Mesmo com tempo limitado ainda consegui fechar uma issue que estava na lista. 🎉🎉
TLDR: Um PR implementando os 6 esquemas de cores que apareciam nas fichas originais, além de algumas melhorias nas instruções do Copilot para melhores contribuições assistidas por IA.
Recapitulando
No fim de semana passado implementei suporte a múltiplos idiomas para o GitFichas com a ajuda do GitHub Copilot. O sistema agora é capaz de suportar qualquer idioma ao invés de apenas português e inglês, o que foi uma grande vitória para localização. Também fiz o Copilot revisar seu próprio trabalho pela primeira vez, o que foi uma experiência no mínimo curiosa, o Copilot até apontou documentação que precisava ser atualizada 👀
O que foi feito neste fim de semana
Apesar da agenda mais corrida que o normal, consegui trabalhar em uma funcionalidade importante e fechar algumas issues.
Implementando os 6 esquemas de cores
PR #209 fechou múltiplas issues de uma vez:
- Issue #63: A issue principal para implementar diferentes esquemas de cores como eu costumava ter quando desenhava as fichas à mão;
- Issues #115, #114, #113, #112, #110: Migração de fichas em português para formato Mermaid;
- Issues #162, #161, #160, #158: Migração adicional de fichas em inglês.
A implementação dos esquemas de cores traz de volta a variedade visual que tornava as fichas originais desenhadas à mão especiais. Agora cada ficha terá um dos 6 temas de cores diferentes:
- Azul claro
- Verde escuro
- Roxo claro
- Rosa
- Roxo e rosa
- Verde claro
As cores são automaticamente atribuídas baseadas no número da ficha usando a operação módulo, então cada ficha tem uma aparência consistente, não importa quantas fichas tivermos.
Cada esquema de cores é feito por um par de cores para que possamos ter subtítulos e pré-títulos em cores diferentes da cor principal do título, como nas imagens abaixo. No topo, a ficha original baseada em imagem, na parte inferior, a nova ficha gerada com Mermaid:
Ao invés da cor única de antes:
Você pode conferir todos os pares de cores neste arquivo. Você também pode ter notado que agora temos a borda na parte do título da ficha também. 🎉
Preparando para a Hacktoberfest assistida por IA
Enquanto migrava as fichas, também aproveitei a oportunidade para melhorar as instruções do GitHub Copilot. Com ferramentas de IA se tornando parte do fluxo de desenvolvimento, quero ajudar as pessoas contribuidoras a terem a melhor experiência possível ao usar essas ferramentas para também tornar seus PRs para o GitFichas melhores.
As melhorias focam em:
- Melhor orientação para geração de diagramas Mermaid
- Instruções mais claras para a migração de fichas desenhadas à mão para Mermaid
- Exemplos mais específicos de como lidar com casos extremos
Eu espero um uso massivo de ferramentas de IA durante este Hacktoberfest, então acertar essas instruções agora vai ajudar todo mundo a ter sucesso, incluindo eu mesma já que vou estar do lado recebendo as contribuições e reviso cada PR pessoalmente mesmo quando peço para o copilot revisar primeiro.
Usar IA para revisar PRs pode acelerar o processo de revisão já que a IA vai pegar detalhes que meus olhos humanos podem perder. Como mantenedora eu vou então poder revisar as mudanças sugeridas e adicioná-las antes de fazer o merge se fizer sentido.
O que vem por aí
Com apenas mais um fim de semana até outubro chegar, estou chegando perto dos preparativos finais do preptember. No próximo fim de semana vou focar em:
- Issue #173 no GitFichas: Gerar uma imagem de preview para cada uma das fichas para torná-las fáceis de compartilhar;
- PR #166 no repositório PyLadiesCon;
- Abrir novas issues para traduções em espanhol e talvez até francês;
- E finalmente, revisar e criar a lista de projetos open source brasileiros que faço todo ano.
GitFichas está quase pronto para a chegada do Hacktoberfest!
Preparação para o workshop do Oktane
Falando em estar ocupada, a maior parte deste fim de semana foi investida me preparando para minha viagem ao Oktane, não só fazendo uma revisão final e ensaios do workshop que vou apresentar mas também garantindo que as roupas estejam prontas para fazer as malas e sim ainda sigo minhas próprias dicas de viagem.
É sempre empolgante compartilhar conhecimento com a comunidade, mesmo quando isso significa menos tempo para projetos pessoais. Como developer advocate eu amo encontrar pessoas desenvolvedoras onde elas estão e tanto palestras quanto trabalho open source, ao meu ver, são partes importantes de retribuir para a comunidade.
Bora lá
Como sempre, se você está planejando contribuir com open source durante o Hacktoberfest, agora é a hora de começar a explorar projetos e se familiarizar com seus processos de contribuição.
Você sabia que a inscrição para o Hacktoberfest 2025 já está aberta? Você pode se inscrever agora mas vale lembrar que os pull requests só vão contar se feitos durante o mês de outubro. Eu já me inscrevi. 👇
GitFichas está esperando suas contribuições! E se você precisar de ajuda para começar sua jornada nesse Hacktoberfest, entre em contato através de qualquer um das redes sociais na web.
