Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
How to manage an
open source project
Juanjo Bazán @xuanxu
h4ckademy
Prerequisites
• You know how to use git
• You know how to use github
Am I ready?
License
License
Add a License.txt file
Which license?
MIT
Apache
GPL
Affero
Beerware
http://ChooseALicense.com
But my code is not
ready!
Yes it is!
Everything is Broken
Release early
Let others spread
your word
Let others fix
your code
Let others fix
your code
Let others improve
your code
What is the goal of
opensource my code?
Increase use of the code
What is the goal of
opensource my code?
Increase use of the code
Benefit from collaboration
What is the goal of
opensource my code?
More use?
How?
More use?
README file
README file
• Present the project
• Step-by-step Install Instructions
• Status of the Project (build info/date/...)
• Basic...
More collaboration?
How?
More collaboration?
CONTRIBUTING file
CONTRIBUTING file
• How to report bugs
• How to suggest improvements / new
features
• How to contribute code
• Style guides
Nurture a community
• Be polite with rejections
• Explain your whys/why-nots
• Answer as much/fast as you can
• Delegate
A common
collaboration model
Github Issues
Use labels wisely
Topic Branches
+
Pull Requests
Delegate
Make
Communication
easy
Slack
Slackline
IRC
Gitter
Take care of your
showcase
Code of conduct
More tools
• Trello
• GH Wikis
• Custom website / GH pages
An open source project
is a community of
PEOPLE
Managing code is
easy
Managing people is
hard
License
Readme file
Contributing file
Time
Love
Good luck!
Thanks!
Questions?
@xuanxu
Picture Credits:
https://www.flickr.com/photos/dhilowitz/16594181774
https://www.flickr.com/photos/kevhar...
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
How to manage an open source project
Upcoming SlideShare
Loading in …5
×

How to manage an open source project

729 views

Published on

Slides for an introductory talk on opensource delivered at h4ckademy, Google Campus Madrid, on august 2015.

Published in: Technology
  • Be the first to comment

How to manage an open source project

  1. 1. How to manage an open source project Juanjo Bazán @xuanxu h4ckademy
  2. 2. Prerequisites • You know how to use git • You know how to use github
  3. 3. Am I ready?
  4. 4. License
  5. 5. License Add a License.txt file
  6. 6. Which license? MIT Apache GPL Affero Beerware
  7. 7. http://ChooseALicense.com
  8. 8. But my code is not ready!
  9. 9. Yes it is!
  10. 10. Everything is Broken
  11. 11. Release early
  12. 12. Let others spread your word
  13. 13. Let others fix your code
  14. 14. Let others fix your code
  15. 15. Let others improve your code
  16. 16. What is the goal of opensource my code?
  17. 17. Increase use of the code What is the goal of opensource my code?
  18. 18. Increase use of the code Benefit from collaboration What is the goal of opensource my code?
  19. 19. More use? How?
  20. 20. More use? README file
  21. 21. README file • Present the project • Step-by-step Install Instructions • Status of the Project (build info/date/...) • Basic use case/examples • Contact info
  22. 22. More collaboration? How?
  23. 23. More collaboration? CONTRIBUTING file
  24. 24. CONTRIBUTING file • How to report bugs • How to suggest improvements / new features • How to contribute code • Style guides
  25. 25. Nurture a community • Be polite with rejections • Explain your whys/why-nots • Answer as much/fast as you can • Delegate
  26. 26. A common collaboration model
  27. 27. Github Issues
  28. 28. Use labels wisely
  29. 29. Topic Branches + Pull Requests
  30. 30. Delegate
  31. 31. Make Communication easy
  32. 32. Slack Slackline IRC Gitter
  33. 33. Take care of your showcase
  34. 34. Code of conduct
  35. 35. More tools • Trello • GH Wikis • Custom website / GH pages
  36. 36. An open source project is a community of PEOPLE
  37. 37. Managing code is easy Managing people is hard
  38. 38. License Readme file Contributing file Time Love
  39. 39. Good luck!
  40. 40. Thanks!
  41. 41. Questions? @xuanxu Picture Credits: https://www.flickr.com/photos/dhilowitz/16594181774 https://www.flickr.com/photos/kevharb/4913784320/ https://www.flickr.com/photos/ksayer/5614813544/

×