DEV Community

Jessica Temporal
Jessica Temporal

Posted on • Originally published at jtemporal.com on

GitFichas agora é Open Source 🎉

Isso significa que se você está procurando um projeto para contribuir, você acabou de encontrar!

O que é GitFichas?

GitFichas é uma coleção de fichas de estudo sobre git. Foi inicialmente de código fechado e mantido somente por mim, principalmente devido ao fato de que eu desenhava cada uma das fichas à mão.

Depois de algum tempo, até criei fontes para facilitar o processo, mas ainda precisava pegar meu iPad e o aplicativo Procreate para transformar minhas anotações em uma imagem.

Eu sempre quis que o gitfichas fosse mais. Mais acessível, mais colaborativo, mais útil. E com mermaid eu acho que podemos conseguir isso.

GitFichas e acessibilidade

Eu dei o meu melhor para melhorar a legibilidade, ajustando o contraste das cores nas fichas. Também adicionei texto alternativo a todas as imagens, bem como uma tabela em cada página individual de cada ficha descrevendo cada parte de cada comando ou conceito.

Mas eu também queria ter um modo escuro, melhores opções de cores para diferentes habilidades visuais e, finalmente, também melhorar o resultado para leitores de tela. É aí que entra mermaid. Mermaid permite gerar fichas baseadas em texto que podem ser personalizados usando CSS e JS.

Essas mudanças também levarão um tempo para acontecer, mas agora são possíveis. ☺️

Por que agora virou open source?

Como diria o Zen do Python: “Agora é melhor do que nunca”.

Tenho trabalhado lentamente para descobrir a próxima versão já tem um tempo e finalmente descobri como customizar e estruturar os gráficos mermaid para que pareçam mais com a versão anterior que eu tinha para as fichas. Então aqui estamos.

Além de melhorar a acessibilidade, essa mudança tornará esse projeto mais parte da comunidade e permitirá melhorias mais rápidas e a publicação de mais fichas, podendo até mesmo ser um trampolim para a comunidade criar outros projetos como esse.

Como contribuir

Abri um pouco mais de 100 issues no repositório do GitFichas que falam sobre melhorias que precisam acontecer para completar a migração para fichas no modo mermaid ao invés de imagens. Você pode trabalhar em uma delas ou em vários delas. Você também pode contar pra sua galera sobre o projeto e convidar geral pra colaborar.

OU.

Você pode enviar uma nova ficha com um novo comando ou conceito. Posso te ajudar a revisar e refinar palavras se precisar. Basta abrir um issue e enviar seu PR, seguindo o guia de contribuição (em inglês) disponível no repositório.

Recapitulando

E do fundo do meu coração: embora já tenha passado um bom tempo desde que publiquei novas fichas, o GitFichas tem sido um dos meus projetos pessoais favoritos. Eu o criei para ajudar pessoas desenvolvedoras como você e eu que podem precisar de ajuda com comandos git de tempos em tempos.

Espero que tornar o GitFichas open source ajude ainda mais pessoas desenvolvedoras com Git. Dito isso, o GitFichas agora é de open source e estou ansiosa para sua contribuição no GitHub. 🎉

Top comments (0)