Pois é, já estamos no meio de setembro e aqui está meu relatório da segunda semana do preptember!
TLDR: PR grande para fechar a issue de suporte a idiomas no GitFichas e mais alguns PRs menores.
Finalmente atualizei o suporte a idiomas com a ajuda do GitHub Copilot em modo Agent e agora o GitFichas é capaz de suportar múltiplos idiomas ao invés de apenas português e inglês, então uma grande vitória para localização.
Si hablas español… estamos procurando contribuições em traduções para espanhol. Se você fala outros idiomas eles também são bem-vindos!
Recapitulando
Na semana passada comecei o preptember corrigindo um problema grande no GitFichas onde os gráficos Mermaid não estavam renderizando corretamente no navegador. A solução foi mudar de renderização no lado do cliente para pré-gerar arquivos SVG usando a CLI do Mermaid.
Também adicionei várias funcionalidades novas incluindo um script de configuração com um comando só, instruções do GitHub Copilot para contribuidores, geração automática de SVG e documentação melhorada. O objetivo era preparar o GitFichas para o influxo de contribuições do Hacktoberfest tornando-o mais acolhedor e fácil de contribuir.
Issues fechadas e pull requests feitos
Esta é a lista do trabalho feito nesse final de semana:
- Issue #204: Atualizar a seleção de idioma;
- PR #205: Este PR implementou o suporte a múltiplos idiomas e fechou a issue acima 🎉
- PR #207: que atualizou o conteúdo da página de contato em português e inglês;
- PR #206: Corrigiu um pequeno erro de lógica introduzido em um PR de fim de semana anterior para a renderização mermaid no navegador.
- PR #208: Ajustes de renderização de fichas
Senta que lá vem história…
Usando Copilot em modo Agent e vibe coding
Pela primeira vez eu fiz o Copilot não apenas fazer a maior parte do trabalho mas também revisando seu próprio trabalho em um PR.
Não sou muito fã de vibe coding, não consigo simplesmente apertar “Keep” para todas as mudanças que a IA faz e não pensar duas vezes antes de fazer commit. Minha cabeça não aceita isso.
Mas o mais próximo que chego de vibe coding é pedir para a IA fazer algo e depois revisar, dar feedback específico sobre o que não está funcionando e pedir para corrigir o que está quebrado. Esse tipo de processo funciona bem mas definitivamente não é tão rápido quanto aceitar cegamente qualquer output que eu receba.
Mesmo assim, os PRs que coloquei no ar esse final de semana me tomaram cerca de 6 horas de trabalho sem foco. Se eu tivesse sido mais focada, provavelmente teria levado 4 horas, mas é fim de semana né?!
Posso dizer com certeza absoluta que sem nenhuma ajuda de IA, entre escrever código novo, refatorar código pré-existente, testar, fazer preview de deployments, ajustes e casos de borda esquecidos, isso provavelmente me tomaria cerca de dois dias para finalizar.
Não só isso, provavelmente significaria que o deploy pra produção teria que esperar até o próximo fim de semana para ir ao ar já que eu gostaria de ter mais tempo para revisar meu próprio trabalho antes de fazer o merge do pull request.
Usando Copilot como revisor de pull requests
E falando de revisão, esta foi a primeira vez que tive o Copilot fazendo a revisão para mim e foi interessante para dizer o mínimo.
Ele chamou minha atenção para a documentação que esqueci de atualizar, assim como para o fato de que meu PR não seguia as diretrizes do projeto. 😂
Deixa eu explicar. Até agora o GitFichas tinha suporte apenas para duas linguagens faladas: português e inglês. E a forma como a localização estava implementada não permitia que outras traduções fossem facilmente adicionadas. Então parte da documentação do projeto deixava claro que o conteúdo do site estava apenas nessas duas linguagens iniciais.
Então definitivamente sorri quando o Copilot apontou que meu PR estava indo contra as próprias diretrizes do projeto de suportar apenas português e inglês.
Esse comentário serviu como um lembrete bem colocado para não apenas atualizar a documentação (o que fiz motivada por outro comentário similar) mas também as instruções do Copilot já que elas são usadas nas revisões além do chat no VS Code.
Próximos passos
A lista de issues para os próximos fins de semana é a seguinte:
- Issue #173 no GitFichas: Gerar uma imagem de preview para cada um dos cards para facilitar o compartilhamento
- Issue #63 no GitFichas: Criar temas diferentes para que cada card pareça um pouco diferente dos outros
Também planejo voltar aos pull requests que deixei de lado durante o ano.
Em particular o #166 no repositório do PyLadiesCon. Mariatta se você estiver lendo isso: sinto muito a demora para voltar a ele, no próximo fim de semana vou resolver os conflitos para podermos fazer o merge.
Nota à parte: Você viu sua lista de pull requests ultimamente? A minha parece que nunca chega a zero. 😂
Vamos juntos
Se você está pensando em contribuir para open source durante o Hacktoberfest, comece a procurar possíveis projetos para os quais quer contribuir. Faça uma lista de projetos, fork e clone os repos, confira os guias de contribuição e comece a se preparar porque outubro está quase aqui.
Como sempre, confira o GitFichas no GitHub e se precisar de ajuda com suas contribuições me mande uma mensagem em um dos muitos lugares sociais por aí! 🎉
Top comments (0)