Guias para contribuir e manter projetos de código aberto
16 guias curtos, cada um com a fonte oficial aberta em 11/10/2026, o link, a licença do conteúdo e um exemplo resolvido.
Que guias existem aqui?
16 guias: 9 para quem vai contribuir (achar o projeto, fork, issue, commit, pull request, revisão) e 7 para quem mantém (versionamento, changelog, código de conduta, SECURITY.md, README e CONTRIBUTING).
Para quem vai contribuir
Do projeto certo ao pull request aceito.
- 01Achar um projetoCinco sinais de projeto vivo, rótulos para iniciantes e o que ler antes de começar.
- 02Fazer o forkO que é o fork, como criar, clonar e ligar o projeto original com o nome upstream.
- 03Atualizar o forkSincronize seu fork com o projeto original: botão, GitHub CLI ou git fetch e merge.
- 04Abrir uma boa issueO que escrever para o problema ser reproduzido em um minuto, com exemplo bom e ruim.
- 05Mensagem de commitOs quatro hábitos do Pro Git e quando usar um -m ou vários.
- 06Conventional CommitsAs 16 regras da especificação 1.0.0 resumidas, com tipos, escopo, ! e BREAKING CHANGE.
- 07Abrir o pull requestCompare & pull request, base e fork de origem, rascunho e como fechar uma issue pela descrição.
- 08Revisar códigoComentar, sugerir e enviar uma revisão no GitHub, com um roteiro de leitura e tom.
- 09Resolver conflito de mergeComo ler as marcas <<<<<<<, ======= e >>>>>>> e concluir o merge na linha de comando.
Para quem mantém um projeto
Os arquivos e as práticas que fazem um projeto receber bem quem chega.
- 01Versionamento semânticoMAJOR, MINOR e PATCH: quando cada número sobe, pré-lançamentos e as regras que surpreendem.
- 02Manter um changelogOs seis tipos de mudança, a seção Unreleased e um CHANGELOG.md pequeno para copiar.
- 03Código de condutaO que um código de conduta deve dizer, onde guardar e como usar o Contributor Covenant.
- 04SECURITY.mdComo criar a política de segurança, ativar o relato privado e um modelo pequeno.
- 05Manter um projetoCinco ideias da Open Source Guides: documentar, dizer não, dividir, automatizar e descansar.
- 06Escrever um READMEAs perguntas que o README responde, uma ordem que funciona e um modelo mínimo.
- 07Escrever um CONTRIBUTINGO que incluir no CONTRIBUTING.md, onde o GitHub o mostra e como não exagerar nas regras.
Sobre licenças de código aberto, este site não repete o assunto: o codigolivre.dev explica cada licença em português. Aqui o foco é o que acontece depois de escolher: como contribuir, como receber contribuições e que arquivos o repositório precisa ter.
Perguntas frequentes
De onde vêm as informações dos guias?
De páginas oficiais abertas em 11/10/2026: GitHub Docs, Open Source Guides, semver.org, conventionalcommits.org, Keep a Changelog, Contributor Covenant e o livro Pro Git. Cada guia mostra o link, o que foi lido, a licença do conteúdo e se a página tem data. O texto é nosso, em português.
Por que os guias não trazem data de publicação?
Porque este é um site de guias, não um blog. Cada guia mostra o dia em que as fontes foram abertas, que é a informação que importa para saber se ainda vale. As páginas oficiais que lemos também não mostram data.
Posso copiar um guia para o meu projeto?
Os exemplos de arquivos (README, CHANGELOG, SECURITY, mensagens) foram escritos para este site e podem ser usados como ponto de partida. O texto das fontes oficiais não é reproduzido aqui; para usá-lo, siga a licença de cada fonte, indicada em cada guia.
E as licenças de código aberto?
Este site não repete o assunto. O codigolivre.dev explica cada licença em português, com o que cada uma permite, exige e proíbe, e ajuda a escolher a sua.
Todas as fontes dos guias
Abertas em 11/10/2026 com rotina de reconferência registrada. Cada guia lista as suas, com o que foi lido.
Este site conta com uma rotina semanal automatizada que reabre as páginas oficiais de documentação (GitHub Docs, Git SCM, Conventional Commits, SemVer, Open Source Guides, Contributor Covenant e SPDX) e verifica se os comandos, termos e regras continuam vigentes. Se alguma página oficial sair do ar ou mudar seu texto, o site mantém a data anterior e o item entra em revisão manual antes de qualquer alteração de conteúdo.
| Fonte | Licença do conteúdo | Data na página | Reconferência | Como usamos |
|---|---|---|---|---|
| GitHub Docs: Finding ways to contribute | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| Open Source Guides: How to Contribute | CC BY 4.0 | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Fork a repository | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Contributing to a project | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Syncing a fork | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Creating an issue | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Issue and pull request templates | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| Pro Git: Contribuindo com um projeto | CC BY-NC-SA 3.0 | a página não mostra | semanal (2026-10-11) | Só link e fatos (git diff --check; limites de 50 e 72 caracteres, tratados aqui como regra prática). Nenhum trecho do livro é copiado ou adaptado, por causa da cláusula NC. |
| Conventional Commits 1.0.0 | CC BY 3.0 | a página não mostra | semanal (2026-10-11) | As regras são resumidas em português e citadas por número. Os trechos em inglês são curtos, de regras, com a fonte ao lado. |
| Conventional Commits 1.0.0 (pt-BR) | CC BY 3.0 | a página não mostra | semanal (2026-10-11) | Só link, para quem prefere ler em português. |
| SemVer 2.0.0 | CC BY 3.0 | a página não mostra | semanal (2026-10-11) | Resumo próprio das regras, em português, com o número da regra. O texto da especificação não é reproduzido. |
| GitHub Docs: Creating a pull request from a fork | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Linking a pull request to an issue | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Reviewing proposed changes in a pull request | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| Keep a Changelog 1.1.0 | MIT | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| Open Source Guides: Your Code of Conduct | CC BY 4.0 | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Adding a code of conduct | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| Contributor Covenant 3.0 | CC BY-SA 4.0 | a página não mostra | semanal (2026-10-11) | Só link e um resumo da estrutura. O texto do código de conduta NÃO é reproduzido neste site, porque a licença exige que obras derivadas usem a mesma licença (CompartilhaIgual). |
| Open Source Guides: Starting a Project | CC BY 4.0 | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Adding a security policy | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Private vulnerability reporting | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| Open Source Guides: Best Practices for Maintainers | CC BY 4.0 | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: About the repository README file | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Setting guidelines for repository contributors | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
| GitHub Docs: Resolving a merge conflict on the command line | CC BY 4.0 (conteúdo); MIT (código) | a página não mostra | semanal (2026-10-11) | Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso. |
- SPDX License List (spdx.org)
Data na página: 16/09/2026 · aberta em · reconferência: confirmada na abertura (11/10/2026) · licença do conteúdo: não confirmada
O que lemos: Versão 3.29.0 da lista, de 16/09/2026. Conferi que MIT, Apache-2.0, BSD-3-Clause, ISC, MPL-2.0, GPL-3.0-only, AGPL-3.0-only, Unlicense e CC0-1.0 estão na lista sem marca de obsoleto; GPL-3.0 está marcado como obsoleto.
Como usamos: Só os identificadores (nomes curtos), conferidos um a um.
Prefere começar pela prática?
Os geradores, o passo a passo e os guias ficam a um clique.
- Primeira contribuiçãoDo fork ao pull request, com os comandos de git para copiar.
- Gerador de READMEPreencha o projeto e copie o README.md pronto.
- Gerador de CONTRIBUTINGDiga como o projeto recebe ajuda e copie o arquivo.
- Mensagem de commitMonte e valide a mensagem no padrão Conventional Commits.
- Praticar no terminalTerminal de faz de conta: do clone ao push, sem mexer em repositório de verdade.