Contributing to Akka (Hacktoberfest 2020)
0 likes62 views
The document discusses how to contribute to open source software projects. It recommends getting a GitHub account, registering for Hacktoberfest, and provides tips for making contributions such as starting with small changes, communicating expectations through pull requests, and choosing projects that are familiar or have requested help. The overall message is that contributing to open source can help overcome fears of making mistakes and that maintainers are generally receptive to contributions.
Contributing to Akka (Hacktoberfest 2020)
- 1. @ignasi35 Contributing to OSS Ignasi Marimon-Clos (Lightbend)
- 2. @ignasi35 Contributing • Code (my PR’s) • Issue • 3rd party PR review • …
- 3. @ignasi35 Contributing • Project Site • Docs • Forums • Chats • Stack Overflow • Talks • Workshops • Blogposts • Tutorials • …
- 4. @ignasi35 Task 1 Get a GitHub account: https://github.com
- 6. @ignasi35 Impediments • It’s all in your head • Really • Even pros make mistakes • Yeah, just do it • It’s all in your head
- 8. @ignasi35 There’s people on the other side
- 12. @ignasi35 Fighting the Impediments • Allocate fixed weekly time • Sign up to Hacktoberfest
- 13. @ignasi35 Fighting the Impediments • No-one is watching. And if someone is watching, that’s even better! You will mess things up, but after 3 years and 200 PRs your successes will exceed your messes.
- 14. @ignasi35 There’s people on the other side
- 16. @ignasi35 Task 2 Register to Hacktoberfest: https://hacktoberfest.digitalocean.com/
- 17. @ignasi35 Hacktoberfest 2020 • Abuse • Only counts PRs • Misses the point
- 18. @ignasi35 Task 3 Start a Contribution
- 19. @ignasi35 Tips
- 20. @ignasi35 Tips • Don’t do it for the t-shirt https://hacktoberfest.digitalocean.com/hacktoberfest-update https://twitter.com/domenic/status/1311355857465225218
- 21. @ignasi35 There’s people on the other side
- 22. @ignasi35 Tips - code • How To Write a Git Commit Message • How to write a PR (to OSS) Message • Manage expectations (newbie, need-help, low dedication, seek-guidance, “WIP - …”) • Why did you do this PR? Related issues? Related discussion (SO/forums/chat)? Why solve it like this (trade-offs)? • Read CONTRIBUTING.md • Follow steps in PR template (if exists)
- 24. @ignasi35 Tips - code • How To Write a Git Commit Message • How to write a PR (to OSS) Message • Manage expectations (newbie, need-help, low dedication, seek-guidance, “WIP - …”) • Why did you do this PR? Related issues? Related discussion (SO/forums/chat)? Why solve it like this (trade-offs)? • Read CONTRIBUTING.md • Follow steps in PR template (if exists) META
- 25. @ignasi35 Tips - code • Start small • Really small • Or automated (lint, automated replace, …) • There’s always time for a bug fix or even a new feature. You’ll get there. Know the irks, the layout and the team first.
- 26. @ignasi35 https://github.com/akka/akka/pull/29623 Do this:
- 27. @ignasi35 Task 3 Start a Contribution
- 28. Akka repos Akka core (actors, streams, cluster,…) Akka HTTP Alpakka and Alpakka-Kafka Akka Persistence plugins Akka gRPC Akka Management (ops) Akka Meta Akka Projection Akka Platform Guide Akka Samples …
- 29. Akka repos Akka core (actors, streams, cluster,…) Akka HTTP Alpakka and Alpakka-Kafka Akka Persistence plugins Akka gRPC Akka Management (ops) Akka Meta Akka Projection Akka Platform Guide Akka Samples …
- 31. @ignasi35 How to choose? • Find out what the team is focused on • Contribute an area you are familiar with already • Find out where the team requested for help already
- 32. @ignasi35 How to choose? • Find out what the team is focused on
- 33. @ignasi35 How to choose? • Find out what the team is focused on
- 34. @ignasi35 There’s people on the other side
- 35. @ignasi35 How to choose? • Contribute an area you are familiar with already
- 36. @ignasi35 How to choose? • Contribute an area you are familiar with already
- 37. @ignasi35 How to choose? • Find out where the team requested for help already
- 38. @ignasi35 How to choose? • Find out where the team requested for help already https://github.com/akka/akka-management/issues/643
- 39. @ignasi35 I chose, now what? • Create an issue (if none exists) to discuss details • Let other contributors know you are working on it • Hack, hack, hack
- 40. @ignasi35 Ready? PR! • When you think you are done, send a PR • Make sure you signed the CLA • Make sure code is formatted, tests pass, etc… • Await 1 or 2 approvals (depends on repo)
- 41. @ignasi35 Task 3 Start a Contribution