Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Contribuindo com projetos OpenSource: a teoria ...
Search
Lucas Mazza
October 19, 2013
Technology
14
10k
Contribuindo com projetos OpenSource: a teoria na prática.
Lucas Mazza
October 19, 2013
Tweet
Share
More Decks by Lucas Mazza
See All by Lucas Mazza
OpenAPI e Elixir (e qualquer outra linguagem)
lucas
0
61
Ecto sem SQL
lucas
0
360
Feature Toggles! - Elixir
lucas
3
480
Feature Toggles! - Ruby
lucas
2
330
Testes automatizados e a prática antes da teoria
lucas
0
390
Circuit Breakers em Ruby
lucas
1
370
The Zen and Art of Refactoring
lucas
4
780
Minitest: voltando ao básico sobre testes
lucas
1
370
10 coisas que eu gostaria de ter aprendido mais cedo
lucas
67
5.3k
Other Decks in Technology
See All in Technology
Deep Security Conference 2025:生成AI時代のセキュリティ監視 /dsc2025-genai-secmon
mizutani
4
3k
cdk initで生成されるあのファイル達は何なのか/cdk-init-generated-files
tomoki10
1
680
ロールが細分化された組織でSREは何をするか?
tgidgd
1
430
Transformerを用いたアイテム間の 相互影響を考慮したレコメンドリスト生成
recruitengineers
PRO
2
470
Copilot coding agentにベットしたいCTOが開発組織で取り組んだこと / GitHub Copilot coding agent in Team
tnir
0
200
三視点LLMによる複数観点レビュー
mhlyc
0
230
Frontier Airlines Customer®️ USA Contact Numbers: Complete 2025 Support Guide
frontierairlineswithflyagent
0
100
振り返りTransit Gateway ~VPCをいい感じでつなげるために~
masakiokuda
4
210
ソフトウェアテストのAI活用_ver1.25
fumisuke
1
620
「現場で活躍するAIエージェント」を実現するチームと開発プロセス
tkikuchi1002
4
520
RapidPen: AIエージェントによる高度なペネトレーションテスト自動化の研究開発
laysakura
1
170
QAを早期に巻き込む”って どうやるの? モヤモヤから抜け出す実践知
moritamasami
2
100
Featured
See All Featured
Being A Developer After 40
akosma
90
590k
Automating Front-end Workflow
addyosmani
1370
200k
10 Git Anti Patterns You Should be Aware of
lemiorhan
PRO
656
60k
JavaScript: Past, Present, and Future - NDC Porto 2020
reverentgeek
50
5.5k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
507
140k
Testing 201, or: Great Expectations
jmmastey
43
7.6k
[RailsConf 2023 Opening Keynote] The Magic of Rails
eileencodes
29
9.6k
Become a Pro
speakerdeck
PRO
29
5.4k
Fireside Chat
paigeccino
37
3.5k
The Psychology of Web Performance [Beyond Tellerrand 2023]
tammyeverts
48
2.9k
Exploring the Power of Turbo Streams & Action Cable | RailsConf2023
kevinliebholz
34
5.9k
The Straight Up "How To Draw Better" Workshop
denniskardys
235
140k
Transcript
Contribuindo com projetos OpenSource a teoria na prática
@lucasmazza
http:/ /www.casadocodigo.com.br/products/livro-html-css
None
Open Source wat?
None
Open Source
Open Source Você
OSS Ruby Ruby on Rails jQuery Redis Git Django Bootstrap
Backbone Node.JS Debian PHP Elixir MySQL Java Android AngularJS Docker MongoDB H5BP Android Play
Open Source não é trabalhar de graça
Open Source não é uma competição
Open Source é sobre cultura
Colaboração Comunicação Aprendizado
Desenvolvedores ajudando desenvolvedores
(Obrigado GitHub <3)
Participando dos projetos você pode aprender muito sobre o código
que você usa no seu dia a dia
Como as coisas funcionam
Como as coisas funcionam Design de APIs
Como as coisas funcionam Design de APIs Performance
Como as coisas funcionam Design de APIs Performance Como fazer
software melhor
Ler o código existente é uma bagagem incrível
Você pode ajudar a definir o rumo da comunidade
E dos projetos que são importantes para você
E o importante é começar a participar
“Dude, sucking at something is the first step towards being
sorta good at something.”
como faz?
Reportando bugs
Reportando bugs Enviando patches
Reportando bugs Enviando patches Participando de discussões
Reportando bugs Enviando patches Participando de discussões Revisando colaborações
Todo mundo começa reportando bugs
Confira as issues existentes
Confira as issues existentes StackOverflow e mailing lists
Confira as issues existentes StackOverflow e mailing lists Explique como
reproduzir o bug
Confira as issues existentes StackOverflow e mailing lists Explique como
reproduzir o bug Stacktraces, versões e tudo mais
Não reporte falhas de segurança publicamente
[email protected]
[email protected]
[email protected]
Aprenda as regras de cada projeto
None
Contributing to Ghost 1. Reporting An Issue 2. Working on
Ghost Core 3. Coding standards 4. Submitting Pull Requests 5. Grunt Toolkit 6. Troubleshooting / FAQ 7. Contributor License Agreement CONTRIBUTING.md @ TryGhost/Ghost
twbs/bootstrap joyent/node rails/rails jashkenas/backbone plataformatec/devise
Triagem de issues e test drive de correções
None
None
None
None
None
None
None
o papel de “suporte” é muito importante
Detalhes de configuração
Detalhes de configuração APIs alternativas
Detalhes de configuração APIs alternativas Issues duplicadas
Detalhes de configuração APIs alternativas Issues duplicadas Benchmarks das suas
apps
Tente corrigir sozinho e envie um Pull Request
$ git clone https://github.com/voce/repo.git $ git checkout -b fix-things #
hack hack hack hack hack $ rake test # Pull Request time! $ git commit $ git push origin fix-things -u
None
Busque opiniões sobre o código
Busque opiniões sobre o código merge / rebase / squash
a vontade
Busque opiniões sobre o código merge / rebase / squash
a vontade Tome o seu tempo para acabar
Busque opiniões sobre o código merge / rebase / squash
a vontade Tome o seu tempo para acabar Repita tudo de novo
Feedback é a maior recompensa que você pode receber em
um Pull Request
“[...] Remember that a PR is the start of a
conversation, not the end of one.” CONTRIBUTING.md @ boxen/puppet-git
“Build First, Discuss Later” Mark McSpadden @ Your First Rails
Pull Request
https:/ /help.github.com/articles/using-pull-requests
http:/ /guidelines.plataformatec.com.br/pull-requests
Nem tudo é sobre escrever código
Documentação e guias
Wikis
Typos, warnings e código obsoleto
rails/docrails github/developer.github.com janl/waaa
não se esqueça
Não existe contribuição “pequena demais”
None
Existe um zilhão de formas de participar
None
Não tenha medo de pedir ajuda
None
Colocando o seu código no mundo
“Porque eu colocaria o meu código no GitHub?”
Manter o seu código para o futuro
Manter o seu código para o futuro Receber ajuda de
outros devs
Manter o seu código para o futuro Receber ajuda de
outros devs Vale mais que o seu LinkedIn
None
1 Escolha uma licença
“Choosing a n OSS license doesn’t need to be scary”
http:/ /choosealicense.com
“Choosing a n OSS license doesn’t need to be scary”
http:/ /choosealicense.com TL;DR: Apache 2.0 ou MIT
2 Escreva um README
Readme Driven Development - @mojombo “Consider the process of writing
the Readme for your project as the true act of creation.”
3 Escreva o seu código
Dave Thomas @ elixir-lang-core “[...]In the meantime, the only truth
is code.”
Faça ser fácil contribuir com o seu projeto
O que eu preciso instalar?
O que eu preciso instalar? Como eu testo o que
eu fiz?
O que eu preciso instalar? Como eu testo o que
eu fiz? Qual o workflow do projeto?
Cuide do seu README.md e CONTRIBUTING.md
Abuse do ferramental da comunidade
Automatize as partes mecânicas
source 'https://rubygems.org' gemspec gem 'country_select', '~> 1.1.1' gem 'railties', '>=
4.0.0', '< 4.1' gem 'activemodel', '>= 4.0.0', '< 4.1' gem 'actionpack', '>= 4.0.0', '< 4.1' gem 'rake' gem 'rdoc' gem 'tzinfo' Bundler
Travis CI
Documentação
Vagrant Boxes
WebHooks
Dedique um tempo para revisar as contribuições
E ajude os outros a melhorar o seu software
Retrocompatibilidade
Retrocompatibilidade APIS e styleguides
Retrocompatibilidade APIS e styleguides Promova contribuidores
Retrocompatibilidade APIS e styleguides Promova contribuidores Lidere por exemplo
Não tenha medo de começar de novo
None
“I have learned that in the open- source world, you
are not your code. A critique of your project is not tantamount to a personal attack.” http:/ /sstephenson.us/posts/you-are-not-your-code
Open Source e código fechado
Open Source é baseado em:
Colaboração
Colaboração Comunicação
Colaboração Comunicação Aprendizado
Desenvolvimento de Sofware é baseado em:
Colaboração
Colaboração Comunicação
Colaboração Comunicação Aprendizado
O que funciona de um lado pode funcionar do outro
Descentralização
Descentralização Visibilidade do que é feito
Descentralização Visibilidade do que é feito Comunicação aberta
Descentralização Visibilidade do que é feito Comunicação aberta Autoria coletiva
“Your team should work like an open source project.” http:/
/tomayko.com/writings/adopt-an-open-source-process-constraints
Obrigado! https:/ /twitter.com/lucasmazza https:/ /speakerdeck.com/lucas