[pt-BR] Open Source Friday Brasil🇧🇷 com Jess Temporal, mantenedora do GitFichas

Key Concepts

• Open Source Friday Brasil: Programa semanal do GitHub Brasil para fomentar o cenário open source no país.
• GitHub Star: Reconhecimento concedido pelo GitHub a contribuidores notáveis da comunidade.
• Developer Advocate: Profissional que atua como ponte entre desenvolvedores e um produto/tecnologia, criando conteúdo e educando.
• Auth0/AuthZero: Plataforma de identidade que oferece serviços de autenticação e autorização.
• RFC (Request for Comments): Documentos que descrevem padrões e especificações técnicas da internet.
• IA (Inteligência Artificial): Ferramenta utilizada para acelerar entregas, analisar dados, detectar vulnerabilidades e auxiliar na criação de conteúdo.
• LLM (Large Language Model): Modelos de linguagem grandes, como ChatGPT, Claude, Gemini, usados para geração e processamento de texto.
• Copilot: Assistente de codificação baseado em IA, desenvolvido pelo GitHub.
• Hacktoberfest: Celebração anual do open source em outubro, que incentiva contribuições a projetos abertos.
• PR (Pull Request): Proposta de alteração em um código-fonte de um projeto, geralmente em um repositório Git.
• Git Fichas: Projeto open source de Jessoral que explica comandos e conceitos Git através de flashcards visuais.
• Jekyll: Gerador de sites estáticos baseado em Markdown.
• Mermaid: Ferramenta baseada em texto para gerar diagramas e fluxogramas em Markdown.
• SVG (Scalable Vector Graphics): Formato de imagem vetorial que mantém a qualidade em qualquer escala.
• Code Spaces: Ambiente de desenvolvimento baseado em nuvem oferecido pelo GitHub.
• Copilot Instructions (.github/copilot_instructions.md): Arquivo Markdown que fornece diretrizes e contexto para o Copilot interagir com um repositório.
• Modo Agente (Copilot): Funcionalidade do Copilot que permite que ele execute ações no repositório (ex: criar arquivos, rodar comandos).
• Verboso: Código que é excessivamente detalhado ou usa mais linhas/palavras do que o necessário.
• Refatoração: Processo de reestruturar o código existente sem alterar seu comportamento externo, visando melhorar a legibilidade, manutenção ou performance.

Introdução ao First Friday e à Convidada

O programa First Friday, uma iniciativa do Open Source Friday Brasil do GitHub Brasil, retornou após uma pausa. O objetivo do programa é destacar projetos open source mantidos ou criados por brasileiros, combatendo a "síndrome de vira-lata" e mostrando a capacidade de inovação nacional. O mês de outubro é especialmente dedicado ao open source devido ao Hacktoberfest. A convidada deste episódio é Jessoral, uma GitHub Star e Developer Advocate na Auth0/AuthZero.

A Vida Fora do Código: Hobbies e Imigração

Jessoral, uma imigrante no Canadá, compartilhou sua vida além da tecnologia. Ela possui diversos hobbies, incluindo crochê, tricô, ponto cruz, e estava aprendendo a tocar teclado. Gosta de andar de bicicleta e recentemente experimentou stand-up paddle, que pretende praticar mais no próximo ano. No passado, tentou aprender patins e ukulele. Ela enfatizou a importância de ter hobbies fora da tela, especialmente para quem trabalha com tecnologia e comunidade, buscando um equilíbrio e melhorando a qualidade de vida através de exercícios e novas experiências.

Carreira em Tecnologia: Developer Advocate na Auth0

Profissionalmente, Jessoral atua como Developer Advocate na Auth0/AuthZero, com foco em Python para autenticação e autorização. Seu trabalho envolve criar vídeos, escrever blog posts e estudar RFCs para explicar a complexidade da segurança em software. Ela demonstra como implementar login e logout usando o produto da Auth0, sempre buscando equilibrar a segurança da aplicação com uma boa experiência do usuário. O principal objetivo da equipe de Developer Advocacy é educar sobre as dificuldades e melhores práticas de segurança, mesmo que o público não utilize o produto da Auth0.

Inteligência Artificial (IA) na Autenticação e Autorização

Jessoral abordou o impacto da IA na indústria de tecnologia, incluindo a área de autenticação. Ela utiliza IA para acelerar suas entregas de conteúdo e prototipar novas funcionalidades. Na Auth0, a IA é empregada para análise de logs de autenticação, detecção de bots e identificação de gargalos ou vulnerabilidades nos sistemas. Ela também ressaltou a importância do uso seguro da IA, alertando contra a inserção de credenciais ou tokens de acesso em LLMs e promovendo boas práticas de integração de IA em aplicações.

Jornada Open Source e o Hacktoberfest

A primeira experiência de Jessoral com open source ocorreu na faculdade, através da comunidade Python de Ribeirão Preto (Grupai). Ela participou de sprints de contribuição, inclusive para a Operação Serenata de Amor. O Hacktoberfest foi um grande incentivo, onde a comunidade se organizava para contribuir e ganhar camisetas. Jessoral explicou que o Hacktoberfest é uma celebração anual em outubro, patrocinada por empresas como Digital Ocean, que incentiva contribuições a projetos open source. Este ano, são necessários seis PRs para ganhar uma camiseta e ter uma árvore plantada, para os primeiros 10.000 participantes.

Projeto Git Fichas: Origem, Evolução e Estrutura

O Git Fichas é um projeto pessoal de Jessoral, criado há cerca de 2-3 anos, com o objetivo de explicar comandos Git de forma fácil e amigável, como flashcards. A ideia surgiu da necessidade de documentar comandos que ela usava frequentemente ou que eram úteis, mas não tão comuns, e também devido à sua própria memória.

• Evolução:
  • Início: Fichas desenhadas manualmente no iPad, com a letra de Jessoral.
  • Fase 2: Criação de uma fonte personalizada para digitar o texto, mantendo apenas as setas desenhadas.
  • Fase Atual: Transição para cartões baseados em SVG e Mermaid, visando melhor acessibilidade (temas claro/escuro) e facilidade de criação. O Mermaid permite gerar diagramas a partir de texto, eliminando a necessidade de desenho manual.
• Estrutura: O Git Fichas é um site estático construído com Jekyll e Markdown. Cada ficha é um "post" com front matter (metadados). Existem dois tipos de fichas:
  • Comando: Explicam comandos Git específicos (ex: git init, git add -p).
  • Conceito: Explicam conceitos gerais (ex: conflito, stash, git tag).
• Acessibilidade: As fichas incluem descrições textuais e alt text para imagens, garantindo que o conteúdo seja acessível mesmo para quem não consegue ver as imagens.
• Internacionalização: O projeto suporta português, inglês e, mais recentemente, espanhol (com traduções em andamento pela comunidade).

Contribuindo com o Git Fichas e o Papel da IA (Copilot)

Jessoral abriu o Git Fichas para contribuições, especialmente durante o Hacktoberfest. Ela detalhou como o projeto está estruturado para facilitar a contribuição, inclusive com o uso de IA.

• Repositório: O projeto está no GitHub e utiliza Code Spaces para desenvolvimento em nuvem, permitindo que Jessoral trabalhe de qualquer lugar.
• Documentação: O arquivo CONTRIBUTING.md contém instruções detalhadas em português e inglês, incluindo o código de conduta e os tipos de fichas.
• Mermaid e SVG: A lógica para gerar os diagramas Mermaid e convertê-los em SVG está em _includes/mermaid_graphs.html. Jessoral explicou como customizou o Mermaid para usar sua fonte personalizada e como a geração de SVG resolveu problemas de renderização e acessibilidade.
• Copilot Instructions: Jessoral criou um arquivo .github/copilot_instructions.md para guiar o Copilot.
  • Propósito: Informar ao Copilot como ele deve agir no repositório, desde como iniciar o servidor Jekyll até as diretrizes de contribuição.
  • Evolução: As instruções começaram simples e foram expandidas conforme Jessoral identificava comportamentos indesejados do Copilot, ajustando-o para seguir as melhores práticas do projeto.
  • Dica: Usar o próprio Copilot para escrever ou refinar as instruções, pois ele "sabe" como prefere recebê-las.
• Copilot como Revisor de PR: Jessoral demonstrou um PR onde o Copilot atuou como revisor. Mesmo tendo gerado grande parte do código com o Copilot em modo agente, o Copilot revisor conseguiu identificar inconsistências (ex: o guia de contribuição não mencionava suporte a espanhol, enquanto o PR adicionava a língua). Isso mostra que a IA pode pegar erros que ela mesma não percebeu inicialmente, mas exige que o desenvolvedor leia e entenda o código gerado.
• Boas Práticas com IA: Jessoral enfatizou que o Copilot tende a gerar código verboso e nem sempre segue as melhores práticas de desenvolvimento. É crucial que o desenvolvedor tenha conhecimento de estruturação de software, modularidade e evite repetições para guiar a IA e refatorar o código gerado.

Dicas para Contribuição Open Source: A Curadoria de Projetos Brasileiros

Para quem busca outros projetos para contribuir, Jessoral mantém uma lista curada de projetos brasileiros para o Hacktoberfest desde 2018. A lista é classificada por linguagem de programação (C#, CSS, Julia, Lua, Python, Perl, Ruby, etc.) e inclui projetos que:

• São mantidos, criados ou desenvolvidos por brasileiros.
• Têm pelo menos uma issue aberta.
• São simpáticos a novos contribuidores.
• Possuem um repositório válido e ativo. A lista é atualizada anualmente, removendo projetos arquivados ou sem issues abertas, e é uma excelente fonte para quem quer praticar uma linguagem ou aprender uma nova.

Conclusão e Perguntas Pessoais

Jessoral concluiu a sessão agradecendo a oportunidade e reforçando a importância da comunidade e da contribuição open source. Em um momento mais descontraído, ela compartilhou suas preferências alimentares:

• Doce canadense favorito: Maple Syrup Taffy, um caramelo de xarope de bordo feito na neve.
• Comidas brasileiras que mais sente falta: Sushi com cream cheese, cupcake Red Velvet da Faeland Cupcake (Florianópolis), pão francês para o café da manhã, batata palha (especialmente com strogonoff) e temperos brasileiros para frutos do mar. Ela mencionou que, morando em Toronto, consegue encontrar muitos produtos brasileiros e aprendeu a cozinhar alguns, como feijão.

A live destacou a importância da comunidade, do aprendizado contínuo e do uso estratégico da inteligência artificial como ferramenta de apoio no desenvolvimento de software e na contribuição para o open source.