Skip to content

Commit a43ed07

Browse files
jtemporaljtemporal
authored
Merge pull request #347 from jtemporal/contribute-to-gitfichas-post
Add contributions guide for GitFichas in English and Portuguese
2 parents b0c7414 + 4961742 commit a43ed07

File tree

2 files changed

+204
-0
lines changed

2 files changed

+204
-0
lines changed

‎_posts/2025-10-14-contribua-com-o-gitfichas.md‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
---
2+
layout: post
3+
bookbanner: true
4+
comments: true
5+
date: 2025-10-14T04:00:00+00:00
6+
description: Mais de 90 issues esperando por você
7+
image: https://res.cloudinary.com/jesstemporal/image/upload/v1640370040/covers/variados_aanizj.png
8+
lang: pt
9+
posts_list:
10+
- resolvendo-conflitos
11+
- 5-dicas-para-fazer-o-seu-pull-request-brilhar
12+
- gitfichas-agora-e-open-source
13+
related: true
14+
tags:
15+
- hacktoberfest
16+
- ai
17+
- git
18+
- opensource
19+
- pull request
20+
- pull requests
21+
title: "Contribua com o GitFichas"
22+
translations:
23+
- url: "/contribute-to-gitfichas"
24+
lang: "en"
25+
---
26+
27+
Procurando um projeto open source para contribuir? Deixa eu te contar sobre o [GitFichas](https://github.com/jtemporal/gitfichas), um projeto de fichas de estudo visuais sobre Git em vários idiomas.
28+
29+
## O que é o GitFichas?
30+
31+
O GitFichas cria fichas de estudo visuais que ajudam devs a entender conceitos do Git através de diagramas. Pense no GitFichas como flashcards de estudo sobre Git, mas construído com tecnologias web modernas e projetado para ser acessível a devs do mundo todo.
32+
33+
O projeto suporta vários idiomas: português, inglês, espanhol, e mais por vir! O GitFichas usa diagramas Mermaid para criar materiais de estudo bonitos e amigáveis.
34+
35+
## Impacto Real
36+
37+
Durante os primeiros 10 dias do Hacktoberfest 2025, o GitFichas viu um engajamento incrível da comunidade com [**mais de 80 pull requests mergeados no total**](https://github.com/users/jtemporal/projects/1/views/10).
38+
39+
Isso não é só sobre números, isso prova que a comunidade quer tornar a educação sobre Git melhor para todos.
40+
41+
## Por que sua contribuição importa
42+
43+
Quando você contribui para o GitFichas, você não está apenas adicionando código ou conteúdo, você também está ajudando outras pessoas a entenderem Git melhor. Cada tradução torna o projeto acessível a novas comunidades. Cada correção de bug melhora a experiência de aprendizado. Cada nova ficha de estudo ajuda alguém a compreender um conceito ou comando novo.
44+
45+
### Bora contribuir?
46+
47+
1. **Explore o projeto no GitHub**: [github.com/jtemporal/gitfichas](https://github.com/jtemporal/gitfichas)
48+
2. **Confira as issues**: Procure por [issues com labels](https://github.com/jtemporal/gitfichas/issues) que correspondam aos seus interesses como `bug` ou `enhancement`
49+
3. **Participe da conversa**: Comente nas issues e faça perguntas ou mostre interesse em trabalhar nelas
50+
51+
Depois faça seu PR.
52+
53+
#### Configure seu ambiente
54+
55+
Eu sugiro que você use o GitHub Codespaces, mas você também pode executar tudo localmente se preferir:
56+
57+
```bash
58+
git clone https://github.com/jtemporal/gitfichas.git
59+
cd gitfichas
60+
./setup.sh # Um comando configura tudo!
61+
```
62+
63+
#### Você pode usar IA para te ajudar
64+
65+
O GitFichas incorpora IA e há instruções do GitHub Copilot para te ajudar a:
66+
67+
- Entender a estrutura do código
68+
- Seguir as convenções do projeto
69+
- Migrar fichas do formato inicial desenhado à mão para o formato atual do Mermaid
70+
71+
#### Faça sua contribuição
72+
73+
Seja traduzindo uma ficha de estudo, corrigindo um erro de digitação, ou migrando uma ficha, toda contribuição torna o aprendizado de Git melhor para pessoas desenvolvedoras do mundo todo. Não se [esqueça de linkar a issue na descrição do seu PR](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue) e aguarde a revisão.
74+
75+
## Tipos de contribuições que amamos
76+
77+
Essas são algumas das contribuições para as quais temos issues no momento:
78+
79+
**1. Traduções**
80+
- Traduzir fichas de estudo existentes
81+
- Adaptar terminologia do Git para diferentes regiões
82+
- Revisar e melhorar traduções existentes
83+
84+
Se você fala outras linguagens, o GitFichas também é capaz de suportar mais idiomas, aproveita pra [adicionar seu voto aqui](https://github.com/jtemporal/gitfichas/discussions/400) sobre quais deveriam ser os próximos idiomas que devemos implementar.
85+
86+
**2. Contribuições técnicas**
87+
- Melhorar responsividade mobile
88+
- Corrigir qualquer bug que você encontrar
89+
90+
**3. Adição de conteúdo**
91+
- Criar novas fichas de estudo para conceitos e comandos do Git
92+
- Melhorar explicações em fichas existentes
93+
94+
## Conecte-se e saiba mais
95+
96+
- **Repositório**: [github.com/jtemporal/gitfichas](https://github.com/jtemporal/gitfichas)
97+
- **Site ao vivo**: [gitfichas.com](https://gitfichas.com/)
98+
- Crie uma nova [Discussion](http://github.com/jtemporal/gitfichas/discussions/)
99+
100+
---
101+
102+
Pronto para tornar o aprendizado de Git melhor para pessoas do mundo todo? Estou ansiosa pelo seu pull request! 🚀

‎_posts/2025-10-14-contribute-to-gitfichas.md‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
---
2+
layout: post
3+
bookbanner: true
4+
comments: true
5+
date: 2025-10-14T04:00:00+00:00
6+
description: Over 90 issues waiting for you
7+
image: https://res.cloudinary.com/jesstemporal/image/upload/v1640360835/covers/miscellaneous_ld0l6r.png
8+
lang: en
9+
related: true
10+
posts_list:
11+
- solving-conflicts
12+
- 5-tips-to-make-your-pull-request-shine
13+
- gitfichas-is-now-open-source
14+
tags:
15+
- hacktoberfest
16+
- ai
17+
- git
18+
- opensource
19+
- pull request
20+
- pull requests
21+
title: "Contribute to GitFichas"
22+
translations:
23+
- url: "/contribua-com-o-gitfichas"
24+
lang: "pt"
25+
---
26+
27+
Looking for an open source project to contribute to? Let me tell you about [GitFichas](https://github.com/jtemporal/gitfichas), a visual study cards project about Git in multiple languages.
28+
29+
## What is GitFichas?
30+
31+
GitFichas creates visual study cards (fichas in Portuguese) that help developers understand Git concepts through diagrams and flowcharts. Think of it as flashcards for Git, but built with modern web technologies and designed to be accessible to developers worldwide.
32+
33+
The project supports multiple languages: Portuguese, English, Spanish, and more coming! It uses Mermaid diagrams to create beautiful and friendly study materials.
34+
35+
## Real Impact
36+
37+
During the first 10 days of Hacktoberfest 2025, GitFichas saw incredible community engagement with [**over 80 total pull requests merged**](https://github.com/users/jtemporal/projects/1/views/10).
38+
39+
This isn't just about numbers - this proves the community wants to make Git education better for everyone.
40+
41+
## Why Your Contribution Matters
42+
43+
When you contribute to GitFichas, you're not just adding code or content, you're also helping other developers understand Git better. Every translation makes the project accessible to new communities. Every bug fix improves the learning experience. Every new study card helps someone grasp a complex concept.
44+
45+
### Ready to Contribute?
46+
47+
1. **Explore the project on GitHub**: [github.com/jtemporal/gitfichas](https://github.com/jtemporal/gitfichas)
48+
2. **Check out the issues**: Look for [issues with labels](https://github.com/jtemporal/gitfichas/issues) that match your interests like `bug` or `enhancement`
49+
3. **Join the conversation**: Comment on issues to ask questions or show interest in working on them
50+
51+
Then make your PR.
52+
53+
#### Set Up Your Environment
54+
55+
I suggest you use GitHub Codespaces but you can also run things locally if you prefer:
56+
57+
```bash
58+
git clone https://github.com/jtemporal/gitfichas.git
59+
cd gitfichas
60+
./setup.sh # One command sets up everything!
61+
```
62+
63+
#### You Can Use AI to Help You
64+
65+
GitFichas embraces AI and there are GitHub Copilot instructions to help you:
66+
67+
- Understand the codebase structure
68+
- Follow project conventions
69+
- Migrate cards from hand-drawn initial format to the current Mermaid format
70+
71+
#### Make Your Contribution
72+
73+
Whether it's translating a study card, fixing a typo, or migrating a card, every contribution makes Git learning better for developers worldwide. Don't [forget to link the issue in your PR description](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue) and wait for me to review.
74+
75+
## Types of Contributions We Love
76+
77+
These are some of the contributions we have issues for at the moment:
78+
79+
**1. Translations**
80+
- Translate existing study cards
81+
- Adapt Git terminology for different regions
82+
- Review and improve existing translations
83+
84+
If you speak other languages, GitFichas is also capable of supporting more languages, feel free to [add your vote here](https://github.com/jtemporal/gitfichas/discussions/400) on what should be the next languages we tackle.
85+
86+
**2. Technical Contributions**
87+
- Improve mobile responsiveness
88+
- Fix any bugs you find
89+
90+
**3. Content Addition**
91+
- Create new study cards for Git concepts and commands
92+
- Improve explanations in existing cards
93+
94+
## Connect and Learn More
95+
96+
- **Repository**: [github.com/jtemporal/gitfichas](https://github.com/jtemporal/gitfichas)
97+
- **Live Site**: [gitfichas.com](https://gitfichas.com/)
98+
- Create a new [Discussion](http://github.com/jtemporal/gitfichas/discussions/)
99+
100+
---
101+
102+
Ready to make Git learning better for developers worldwide? I’m looking forward to your pull request! 🚀

0 commit comments

Comments
 (0)