Contribuir Para Open Source Como Colaborador e Maintainer

Contribuir para projectos Open Source (código aberto) pode ser intimidante. Como colaborador, normalmente tens de te familiarizar com um projeto para contribuir. Como maintainer, és responsável por fazer o projeto avançar e gerir as suas contribuições. Quer sejas um maintainer ou um colaborador, ambos os lados têm seus desafios. Nesta apresentação, quero partilhar minha experiência e perspectiva de contribuir para Open Source de ambos os lados, enquanto partilho dicas sobre como começar a contribuir para um novo projeto e sobre como manter um projeto de forma atrativa para novos colaboradores. No final da apresentação, perceberás como podemos colaborar de forma mais eficaz, se entendermos cada lado.

Transcript

1. Contribuir Para Open Source Como Colaborador e Maintainer Isabel Costa @isabelcmdcosta #devfestPT
2. • Software Engineer @ Globality • Admin @ AnitaB.org Open Source • GSoC ‘18, ‘20; GCI ‘19 @isabelcmdcosta @isabelcosta isabelcosta.github.io Isabel Costa @isabelcmdcosta #devfestPT
3. Agenda • Como me tornei colaboradora... • 7 lições como colaboradora • Como me tornei maintainer... • 7 lições como maintainer • Conclusões finais @isabelcmdcosta #devfestPT
4. Como me tornei Colaboradora... @isabelcmdcosta #devfestPT
5. Gostava de … Como começar? Open Source @isabelcmdcosta #devfestPT
6. REJEIÇÃO 2016 @isabelcmdcosta #devfestPT
7. Dezembro 2017: Primeira PR durante 24 Pull Requests @isabelcmdcosta #devfestPT
8. ACEITE 2018 @isabelcmdcosta #devfestPT
9. @isabelcmdcosta #devfestPT
10. O que aprendi sobre ser colaboradora até agora? @isabelcmdcosta #devfestPT
11. Ajuda ter interesse naquilo para que se está a contribuir @isabelcmdcosta Lição 1 #devfestPT
12. Porquê contribuo para Open Source? • Praticar e aprender novas competências • Construir portfolio • Contribuir de volta para a comunidade (Voluntariado) • Adoro o aspecto de comunidade de OS @isabelcmdcosta #devfestPT
13. Há muitos recursos, projetos e comunidades ao qual podes contribuir @isabelcmdcosta Lição 2 #devfestPT
14. Projects @isabelcmdcosta #devfestPT
15. Iniciativas @isabelcmdcosta #devfestPT
16. Não tens de saber programar para contribuir @isabelcmdcosta Lição 3 #devfestPT
17. Design @isabelcmdcosta Source: https://github.com/genuinetools/pepper/pull/4 #devfestPT
18. Garantia de qualidade @isabelcmdcosta #devfestPT
19. Conteúdo @isabelcmdcosta #devfestPT
20. Conteúdo Source: https://github.com/scala-exercises/exercises-fpinscala/pull/55 @isabelcmdcosta #devfestPT
21. Conteúdo @isabelcmdcosta #devfestPT
22. Bug fixes Source: https://github.com/getodk/collect/pull/1986 #devfestPT @isabelcmdcosta
23. Feedback Credit: http://systers-opensource.blogspot.com/2018/02/the-importance-of-feedback.html @isabelcmdcosta #devfestPT
24. Outras formas de contribuir • Rever código em pull requests • Sê mentor em iniciativas OS • Ajuda outros a contribuir • Ajuda a melhorar documentação • Promove o projeto • Reportar bugs e falhas • Gere issues e contribuidores • … usa os teus fortes! @isabelcmdcosta #devfestPT
25. Nem todos os projetos e comunidades são geridas da mesma forma @isabelcmdcosta Lição 4 #devfestPT
26. Sê sincero/a sobre expectativas @isabelcmdcosta Lição 5 #devfestPT
27. Confiança melhora com o tempo @isabelcmdcosta Lição 6 #devfestPT
28. Passos para uma contribuição Fork Clona Trabalha Commit & Push Submete PR Comunica e faz perguntas! #devfestPT @isabelcmdcosta
29. Tirar maior partido de Open Source requer trabalho Lição 7 #devfestPT @isabelcmdcosta
30. O que ter em consideração ... • Será a comunidade acolhedora e inclusiva? ◦ Código de conduta e instruções de como reportar? ◦ Discussões na comunidade • As discussões da comunidade são transparentes? • Permite diferentes tipos de contribuições? • O projecto está ativo? ◦ Dia do último commit? # issues pull requests abertas @isabelcmdcosta #devfestPT
31. Como me tornei Maintainer... @isabelcmdcosta #devfestPT
32. O que aprendi sobre ser maintainer até agora? Eis 7 lições @isabelcmdcosta #devfestPT
33. Não tens de saber tudo @isabelcmdcosta Lição 1 #devfestPT
34. Podes aprender de colaboradores @isabelcmdcosta Lição 2 #devfestPT
35. Diversidade de colaboradores @isabelcmdcosta Lição 3 #devfestPT
36. Um colaborador não desistiu e resolveu o seu problema! (...) @isabelcmdcosta #devfestPT
37. Pode ser estressante manter um projeto “popular” @isabelcmdcosta Lição 4 #devfestPT
38. Fiz merge de código que partiu Swagger Docs! @isabelcmdcosta #devfestPT
39. Consegui resolver o bug rapidamente! @isabelcmdcosta #devfestPT
40. Pode ser estressante manter um projeto “popular” @isabelcmdcosta Lição 4 #devfestPT
41. Podes partilhar responsabilidades como maintainer @isabelcmdcosta Lição 5 #devfestPT
42. Dois membros da comunidade ajudaram a rever o código! @isabelcmdcosta #devfestPT
43. Colaboradores não encontram o projecto do nada @isabelcmdcosta Lição 6 #devfestPT
44. Como atrair novos colaboradores • Promove o projeto ◦ Participa em iniciativas de Open Source ◦ Escreve blog posts e apresenta o projeto em meetups • Configuração fácil de projecto • Plano sobre o desenvolvimento futuro • Issues para iniciantes ◦ Categoriza como “good first issue” ou “first timer only” • Meios de comunicação • Boa documentação @isabelcmdcosta #devfestPT
45. @isabelcmdcosta #devfestPT
46. Resources • Licença → https://choosealicense.com/ • Código de conduta → https://www.contributor-covenant.org/ • Guias sobre tudo relacionado com OS → https://opensource.guide/ • Promover projeto → zenika-open-source/promote-open-source-project • Ferramentas de automação: ◦ GitHub Actions, Codecov, Codacy, Code Climate, CircleCI, TravisCI, ... • Bot em destaque → all-contributors/all-contributors @isabelcmdcosta #devfestPT
47. Ser maintainer é uma posição de liderança @isabelcmdcosta Lição 7 #devfestPT
48. Notas finais... @isabelcmdcosta #devfestPT
49. Sê paciente Sê receptivo/a Sê amigável @isabelcmdcosta #devfestPT
50. "(...) the world is a better place when everyone takes time to understand one another. (...)" from Special Books by Special Kids video: https://www.youtube.com/watch?v=5pWrZQZb4BM @isabelcmdcosta #devfestPT
51. Obrigada! @isabelcmdcosta @isabelcosta isabelcosta.github.io #devfestPT