Forks e open source
Contribua com projetos nos quais você não pode fazer push, mantenha o seu fork sincronizado e entenda as licenças e a etiqueta do open source.
- Contribuir por meio de um fork: clonar, criar branch, fazer push e abrir um pull request para o upstream
- Manter um fork sincronizado com o repositório upstream
- Escolher uma licença open source e seguir as normas da comunidade
Você não pode fazer push num repositório no qual não tem acesso de escrita - o que vale para a maior parte do mundo open source. Em vez disso, você faz um fork: o GitHub cria uma cópia na sua conta na qual você pode fazer push, e o seu pull request vai do seu fork de volta para o original, chamado de upstream.
1# Fork on GitHub first (or: gh repo fork dungeon-dash/dungeon-dash --clone)
2git clone git@github.com:you/dungeon-dash.git
3cd dungeon-dash
4git remote add upstream https://github.com/dungeon-dash/dungeon-dash.git
5
6git switch -c fix/typo-in-controls
7# ...fix, commit...
8git push -u origin fix/typo-in-controls # to YOUR fork
9gh pr create --repo dungeon-dash/dungeon-dash # PR from your fork to upstream
10
11# Later: bring your fork's main up to date with upstream
12git switch main
13git fetch upstream
14git merge --ff-only upstream/main # or the "Sync fork" button on GitHub
15git push origin mainAgora são dois remotes: origin (o seu fork, para onde você faz push) e upstream (o original, de onde você faz fetch). Antes de começar um trabalho novo, sincronize a main com o upstream e crie a branch a partir dela, para que o seu PR não carregue histórico desatualizado. O GitHub mostra na página do repositório quantos commits o seu fork está “à frente” (ahead) e “atrás” (behind) do upstream.
Licenças open source
Uma licença é o que transforma “público” em “open source”: ela dá a todos permissão para usar, mudar e compartilhar o código, sob certas condições. As mais comuns:
| Licença | Numa frase |
|---|---|
| MIT | faça quase qualquer coisa, só mantenha o aviso de copyright - curta e permissiva |
| Apache 2.0 | permissiva como a MIT, mais uma concessão explícita de patentes |
| GPL 3.0 | “copyleft”: se você distribuir versões modificadas, elas também precisam ser GPL, com o código-fonte |
| AGPL 3.0 | uma GPL que também vale quando o software é oferecido pela rede |
| Sem licença | todos os direitos reservados - ninguém pode reutilizá-lo legalmente |
O GitHub lê o arquivo LICENSE e mostra a licença na página do repositório; o choosealicense.com ajuda você a escolher.
Experimente
Até 15 XPPermissiva ou copyleft?
Classifique cada situação pelo tipo de licença que ela descreve.
“Uma empresa pode usar o código num produto de código fechado, mantendo o aviso”
“Se você distribuir uma versão modificada, precisa compartilhar o código-fonte dela sob a mesma licença”
“Um repositório público sem arquivo LICENSE”
“Inclui uma concessão explícita dos direitos de patente dos contribuidores”
“Rodar uma versão modificada como serviço web exige oferecer o código-fonte dela aos usuários”
““Você pode olhar, mas não copiar nem modificar””
Sendo um bom cidadão do open source
- Leia o
CONTRIBUTING.mdprimeiro: ele explica como o projeto quer receber contribuições (testes, estilo de commit, sign-offs). - Procure as labels “good first issue” e comente antes de começar um trabalho grande - alguém pode já estar nele, ou os mantenedores podem querer outra abordagem.
- Siga o código de conduta (
CODE_OF_CONDUCT.md). Os mantenedores muitas vezes são voluntários; paciência e gentileza vão longe. - PRs pequenos são mesclados. Uma correção focada tem muito mais chance de ser aceita do que uma reescrita gigante.
- Os projetos dos quais você depende podem ser apoiados pelo GitHub Sponsors.
Principais conclusões
Faça fork para ter uma cópia na qual você pode fazer push; abra PRs do seu fork de volta para o upstream.
Adicione o original como
upstreame sincronize a main com ele antes de começar um trabalho novo.As licenças tornam o código open source: MIT e Apache são permissivas, a GPL é copyleft.
Leia o CONTRIBUTING.md, comece pelas good first issues e mantenha os PRs pequenos e gentis.
Quiz da aula
7 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: automatize tarefas do GitHub com Python
O trabalho real no GitHub envolve muita automação pequena: conferir CODEOWNERS, expandir matrizes de build, atualizar versões, ler a API. Escreva esses utilitários em Python e execute-os com entradas de exemplo, localmente no navegador e sem precisar de conta no GitHub.
À frente e atrás
O GitHub diz que o seu fork está “3 commits ahead, 2 behind”. A entrada tem duas linhas, upstream: e fork:, cada uma listando os commits de uma branch do mais antigo para o mais novo. Elas compartilham um começo comum (a merge base). Imprima merge base: b, depois ahead 1: x (os commits do fork depois da base) e behind 2: c d (os do upstream), e uma recomendação: up to date, sync with upstream (só atrás), ready for a pull request (só à frente) ou diverged: sync before opening a pull request (os dois). Imprima - para listas vazias.
- Divergiu
- Atrás
- Atualizado
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Bot conselheiro de licenças
Escreva um pequeno conselheiro de licenças. Cada linha de entrada responde a três perguntas de sim/não (yes/no) sobre um projeto: copyleft patents network - o autor quer que as versões modificadas continuem open source? Quer uma concessão explícita de patentes? O projeto vai rodar principalmente como serviço web? Recomende:
- copyleft e network →
AGPL-3.0 - copyleft →
GPL-3.0 - patents →
Apache-2.0 - caso contrário →
MIT
Imprima project 1: MIT e depois uma linha final contando cada licença recomendada, da mais comum para a menos comum, empates em ordem alfabética: MIT x2, GPL-3.0 x1.
- Quatro projetos
- Fãs de copyleft
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…