Este documento fornece conselhos e lições aprendidas sobre contribuir para projetos open source, incluindo começar com projetos que você já usa, fazer pequenas mudanças, não levar rejeições pessoalmente, e contribuir regularmente para manter um ritmo sustentável.

1. Aprendendo com
projetos open source

2. Mauro quem….

5. maurogeorge.com.br

6. História

7. shoulda-matchers
Descoberto a necessidade de dar
suporte a nova versão do Rails

8. Suporte ao novo Rails
Descoberto bug no Rails

9. Reportando issue no Rails

10. Agradecimento da thoughtbot
Menção no post e adesivos =D

11. Experiência
Entender o shoulda-matchers por baixo dos
panos
Criar um novo matcher para o shoulda-matchers
Utilizar uma versão do Rails ainda em
desenvolvimento
Aprendi um pouco sobre Rails por baixo dos
panos
Criei uma issue no Rails

12. Disclaimer
Baseado em fatos reais

13. Sua primeira
contribuição

14. Git + Github

15. Começe pelos projetos que já utiliza

16. Busque por issues

17. Documentação

18. Contribuição com a
documentação ao invés
de um Post

19. $ git clone

20. Rode o projeto

21. Issue ao rodar
o projeto

22. CONTRIBUTING

23. Faça suas
mudanças

24. Faça o fork

25. Faça o PR

26. Faça o PR
Faça sua mudança em um
branch
Deixe claro o que está
resolvendo
Adicione testes nas suas
mudanças

27. Comemore

28. A comunidade

29. A comunidade
Owner - O criador do projeto
Maintainers e Collaborators - São os
mais ativos no projeto
Contributors - Quem já teve um PR
aceito no projeto
Membros da comunidade - Quem
está envolvido nas discussões

30. Meu PR não foi
aceito :(

31. Não se sinta mal
Entenda o motivo, o racional por
trás da decisão, não leve para o
pessoal

32. Faça prova de
conceito
E leve para a comunidade como um PR

33. O review é do
código e não seu

34. Pode demorar até algo acontecer

35. Faça mudanças pequenas

36. Faça mudanças pequenas
Projeto estava pedindo ajuda
PRs menores foram aceitos
Decidi abraçar uma grande
mudança, mesmo sabendo dos
riscos
Velocidade X Qualidade

37. Não leve para o
pessoal e siga em
frente

38. Oh My! Eles vão ver meu código
será que tá
bom?

39. Aprenda com os
erros e melhore

40. Acompanhe os repositorios
Que quer contribuir ou que já
contribuiu

41. Responda
Issues

42. Tudo bem em
não contribuir <3

43. Code review

44. Code review
Aceite que muitas das discussões são opiniões
então discuta os tradeoffs
Lembre-se sempre que do outro lado está falando
com pessoas
Faça perguntas e não demandas
Evite comparar “meu”, “seu”, “não meu”
Seja o mais claro possível
Agradeça
Não leve para o pessoal

45. Trabalhar em um
ou mais projetos?

46. Ritmo
sustentável

47. Ritmo sustentável

48. Programe-se

49. Programe-se
Estude coisas novas
Faça posts
Contribua em projetos open
source
Se divirta =D

50. A gem X é uma
merd*!

51. Provide Options, Don't Make Lame Excuses

52. Não crie projetos,
abrace os existentes

53. Crie issues em
caso de problemas

54. Crie issues
Busque por issues existentes
Seja bem claro, qual o comportamento
esperado e o que ocorreu
Inclua o máximo de informações:
Sistema operacional, versão dos
projetos, versão de dependencias etc
Cole o erro, o stacktrace

55. O que ganho
com isso?

56. O que ganho com isso?
É um modo de aprender assim
como livro, cursos, posts etc.
Contato com pessoas da
comunidade de diversas partes do
mundo e empresas diferentes
Ler código dos outros é uma
excelente forma de aprender

57. Obrigado!

58. Referências
https://guides.github.com/overviews/os-
contributing/
https://github.com/thoughtbot/guides/tree/
master/code-review
https://medium.com/@raphamorim/como-ser-
um-desenvolvedor-transante-parte-i-
e010c125847f
https://medium.com/@raphamorim/como-ser-
um-desenvolvedor-descolado-6d085bcb36e1