Open source

10 projetos open source para fazer a sua primeira contribuição.

Um PR aceito fica público no seu GitHub, revisado por devs de outros países. É o portfólio que empresa de fora abre. Comece pelo primeiro para treinar o fluxo e depois escolha o projeto da sua linguagem.

O caminhoissue de iniciantepedir para pegarfork e branchPR pequenoreviewmerge

Contribuição em projeto de fora é o primeiro passo para a vaga lá fora. Na mentoria, eu monto com você o plano de estudo para a vaga que você quer, ajusto o seu LinkedIn e te ensino a achar as melhores vagas.

Projeto01

first-contributions

firstcontributions/first-contributions · Git

Repositório feito para treinar o primeiro PR, com tutorial em português.

Comece por: Adicione o seu nome no arquivo Contributors.md e abra o PR seguindo o tutorial.

Abrir no GitHub ↗
Projeto02

MDN em português

mdn/translated-content · Markdown

A documentação que todo dev web usa, com uma versão em pt-BR feita pela comunidade.

Comece por: Issues com a label l10n-pt-br: traduções faltando e correções.

Abrir no GitHub ↗
Projeto03

React em português

reactjs/pt-br.react.dev · Markdown

A documentação oficial do React em português. Cada página traduzida é um PR.

Comece por: Escolha uma página ainda em inglês e abra o PR com a tradução.

Abrir no GitHub ↗
Projeto04

BrasilAPI

BrasilAPI/BrasilAPI · JavaScript

API pública e gratuita com CEP, CNPJ, bancos e feriados nacionais.

Comece por: Issues com a label good first issue.

Abrir no GitHub ↗
Projeto05

Querido Diário

okfn-brasil/querido-diario · Python

Raspadores que coletam os diários oficiais dos municípios brasileiros.

Comece por: Issues com a label good first issue.

Abrir no GitHub ↗

Mentoria

Metade da lista. Agora, mire na vaga lá fora.

Código revisado e aceito por gente de fora conta muito na entrevista com empresa gringa. Na mentoria, eu monto com você o plano de estudo para a vaga que você quer, ajusto o seu LinkedIn e te ensino a achar as melhores vagas.

Projeto06

freeCodeCamp

freeCodeCamp/freeCodeCamp · TypeScript

A plataforma gratuita que ensina programação para milhões de pessoas no mundo.

Comece por: Issues com a label first timers only. Guia oficial em contribute.freecodecamp.org.

Abrir no GitHub ↗
Projeto07

Excalidraw

excalidraw/excalidraw · TypeScript e React

O quadro branco de desenhos à mão que muita equipe usa para desenhar arquitetura.

Comece por: Issues com a label good first issue.

Abrir no GitHub ↗
Projeto08

Rocket.Chat

RocketChat/Rocket.Chat · TypeScript

Plataforma de chat open source usada por empresas e governos.

Comece por: Issues com a label good first issue.

Abrir no GitHub ↗
Projeto09

Hoppscotch

hoppscotch/hoppscotch · TypeScript e Vue

Cliente de API open source, alternativa ao Postman que roda no navegador.

Comece por: Issues com a label good first issue.

Abrir no GitHub ↗
Projeto10

Home Assistant

home-assistant/core · Python

Plataforma open source de automação residencial: lâmpadas, sensores e rotinas da casa.

Comece por: Issues com a label good first issue.

Abrir no GitHub ↗

O passo a passo do primeiro PR

1. Leia antes de tudo. README, CONTRIBUTING.md e o código de conduta. Eles dizem como o projeto quer receber o PR.

2. Escolha uma issue de iniciante. Comente pedindo para pegar e espere a resposta quando o projeto pede atribuição.

3. Fork, clone e branch. Faça o fork no GitHub e trabalhe em uma branch com nome curto.

4. Mude pouco e rode os testes. Uma issue por PR. Rode os testes e o lint do projeto antes de subir.

5. Abra o PR em inglês. Explique o que mudou, por que e como testar. Ligue a issue com “Closes #123”.

6. Responda o review. Agradeça, ajuste e faça push na mesma branch. O PR atualiza sozinho.

git clone https://github.com/SEU-USUARIO/projeto.git
cd projeto
git checkout -b fix/descricao-curta
# faça a mudança e rode os testes do projeto
git add .
git commit -m "fix: descrição curta do que mudou"
git push origin fix/descricao-curta
# no GitHub: Compare & pull request

Mensagens prontas em inglês

Pedir a issue:

Hi! I'd like to work on this issue. Could you assign it to me?

Tirar uma dúvida:

I'm working on this and I have a question: [sua pergunta]. Could you point me in the right direction?

Responder o review:

Thanks for the review! I've updated the PR with your suggestions.

Lembrar com educação:

Hi! Just checking in: is there anything else I should change in this PR?

Modelo de descrição do PR

## What
Fix the broken link in the installation guide.

## Why
Closes #123

## How to test
1. Run npm run docs
2. Open /install and click the link

goodfirstissue.dev (issues de iniciante por linguagem) ↗ · Up For Grabs (projetos que pedem ajuda) ↗ · GitHub Docs: contribuir para um projeto (pt) ↗ · Tutorial first-contributions em português ↗

O júnior mostra tutorial. Quem é chamado mostra código aceito.

O júnior só mostra projeto de tutorial. Quem é chamado mostra código revisado e aceito por gente de fora.

Regra: uma issue por vez e PR pequeno. PR pequeno é revisado rápido.

Contribua lá fora e chegue à vaga em dólar

Open source abre a porta. A mentoria acelera esse caminho: plano de estudo para a vaga que você quer, LinkedIn que mostra o seu trabalho e as empresas certas para conversar.