Este documento discute como e por que participar de projetos open source. Explica que enviar código é a forma mais direta de contribuir, mas requer entender o projeto, seus objetivos e padrões. Também discute como reportar bugs, fazer traduções, documentação e evangelização podem ajudar projetos sem necessariamente saber programar.

1. POR QUE E COMOPOR QUE E COMO
PARTICIPAR DEPARTICIPAR DE
PROJETOS OPENPROJETOS OPEN
SOURCESOURCE

2. Júlio Biason
Azion Technologies
@juliobiason
julio.biason@gmail.com
http://presentations.juliobiason.net

3. MOTIVAÇÃOMOTIVAÇÃO

4. POR QUEPOR QUE
PARTICIPAR?PARTICIPAR?
Para retornar à comunidade
"Code rot"
"Scratch an itch"
Fator abandono.

5. COMO PARTICIPARCOMO PARTICIPAR
Enviar código com novas features é a forma mais
direta mas não a mais fácil.

6. ENVIAR CÓDIGOENVIAR CÓDIGO
Aclimate-se ao ambiente do projeto (IRC, Maillist,
Slack, etc)
Seguir os padrões de codificação do projeto
(HACKING.md)
Entender os objetivos do projeto (isso está na
cabeça dos mantenedores)
Anedota: Mitter.

7. ENVIAR CÓDIGOENVIAR CÓDIGO
Lembre-se: para alguém, o projeto é seu filho.
Anedota: IceWM.

8. ENVIAR CÓDIGOENVIAR CÓDIGO
Algumas vezes, o projeto já está abandonado pelo
autor original, mas a comunidade ainda mantém
indiretamente.
Anedota: Blackbox.

9. ENVIAR CÓDIGOENVIAR CÓDIGO
Muito raramente, o desenvolvedor simplesmente não
tem tempo para pesquisar como corrigir uma feature
que ele mesmo quer colocar.
Anedota: Htop.

10. COMO PARTICIPARCOMO PARTICIPAR
Bug reports

11. BUG REPORTSBUG REPORTS
Quando encontrar um problema, tente repetir; tente
isolar o que causa o problema (uma configuração, o
nome do arquivo); se conseguir, envie para o
desenvolvedor.
Anedota: Skyrim.

12. BUG REPORTSBUG REPORTS
Se possível, crie um teste que mostre como o
problema se repete (o que é mais fácil para bibliotecas
e frameworks do que projetos).
Anedota: MongoEngine.

13. O FORKO FORK
Quando o desenvolvedor original do projeto não tem
mais interesse e não quer continuar, sempre há a
possbilidade de ter um desenvolvimento em separado.
Anedota: Jenkins, Pillow

14. O FORKO FORK
... e há vezes que um fork, com ajuda da própria
comunidade, volta para o projeto original.
Anedota: Compiz, GCC

15. COMO PARTICIPARCOMO PARTICIPAR
Traduções

16. TRADUÇÕESTRADUÇÕES
Se você não entende de código, pode ajudar
traduzindo a aplicação para a sua língua.
Anedota: Mitter e Fábio Beneditto

17. COMO PARTICIPARCOMO PARTICIPAR
Artwork

18. ARTWORKARTWORK
Muitos projetos precisam de um site bonito e até
mesmo um logotipo interessante. Ajudar o
desenvolvedor mantendo um site que consiga
comunicar o objetivo do projeto sempre ajuda.
Anedota: Alguma-Coisa-Dog.

19. COMO PARTICIPARCOMO PARTICIPAR
Documentação

20. DOCUMENTAÇÃODOCUMENTAÇÃO
Desde "como instalar esse projeto" ao "o que ele faz",
ainda falta documentação de muita coisa. Nem é
preciso saber programar, pegando algumas dicas com
o autor do projeto.
Dica: Embora alguns desenvolvedores reclamem da
falta de man pages, é possível fazer coisas bem legíveis
usando projetos como e .ReadTheDocs Gitbook

21. COMO PARTICIPARCOMO PARTICIPAR
Doações

22. DOAÇÕESDOAÇÕES
Alguns projetos tem pessoas trabalhando full time e
precisam de alguma forma de pagar essas pessoas.
Anedota: VIM, Mozilla

23. COMO PARTICIPARCOMO PARTICIPAR
Evangelização

24. EVANGELIZAÇÃOEVANGELIZAÇÃO
Você pode ajudar um projeto a crescer divulgando o
mesmo em palestas ou até mesmo comentando com
seus colegas.
Dica: Evite guerras santas do tipo "meu projeto vs seu
projeto".
Anedota: Eu ;).

25. COMO PARTICIPARCOMO PARTICIPAR
"Obrigado"

26. "OBRIGADO""OBRIGADO"
Poucas coisas conseguem ser tão poderosas como um
simples "obrigado por ter feito esse projeto".
Dica: Cerveja e Pizza também contam como obrigados.
Anedota: Htop.

27. PERGUNTAS?PERGUNTAS?