"For the May installment of Hong Kong JS we're going to do things a little different, in that we'll be trying a workshop style format AND exploring how we can build an open source project together. This is something we've tried a few times and it would be awesome to see if it can get some real momentum behind it!"

1. Let's Explore and Build
an Open Source Library
or Framework Together
Kevin Bluer, Bart Verkoeijen, Zak Burki

2. Welcome :)))

3. Agenda

4. Agenda
๏ Housekeeping / HKJS in #’s / Thank You x2
๏ Session Goals
๏ What is Open Source?
๏ Contributor and Maintainer Considerations
๏ Get Tooled Up (Git, Github, NPM)
๏ Pull Requests for everyone!
๏ Brainstorming + Getting Started
๏ Next Steps + Lucky Draw

5. Housekeeping
๏ Wifi - Metta1 / WeAreMetta
๏ Drinks + Restrooms
๏ Future topics / speakers welcome!
๏ Setup on Slack and Github
๏ slack.hongkongjs.com

6. HKJS in #’s
๏ 12th Meetup :)
๏ 1,000 Members as of today
๏ 133 Slack Members (slack.hongkongjs.com)
๏ 2 failed attempts at building kicking off an open
source project, tonight we will try and change that!

7. Thank You x2

8. Mettā
๏ http://metta.co
๏ “Mettā is an entrepreneurs' club that connects
people, ideas and resources. We believe that by
bringing startup communities and ecosystems
closer together, great things can happen.”
๏ If you’re interested in joining or getting involved, just
let me know at kevin@nest.vc :)

9. Metta

10. HKOSCon 2016
๏ 4th Hong Kong Open Source Conference
๏ 24-26 June 2016 (Friday-Sunday) in Cyberport
๏ http://2016.opensource.hk
๏ 4 free tickets to give away :)
๏ Randomly pick 4 people from the list

11. Session Goals

12. Inspiration
๏ Kent Dodd’s Medium posts, “First Timers Only" and
“How to Contribute to Open Source”
๏ “The big challenge we face when inviting new
people to jump on the open source bandwagon is
knowing how to get started.”
๏ http://makeapullrequest.com
๏ PRs Welcome Badge…

13. Goals
๏ #1 To get everyone to contribute at least one PR to
a repository (https://github.com/hongkongjs/
resources)
๏ #2 Brainstorm and kick-off a some project(s)

14. What is Open Source?

15. It’s this…

16. And this…

17. Annnd this…

18. In other words
๏ Great software that’s powering the world!
๏ Built and maintained by a community
๏ Reasons for contributing vary…
๏ Fun
๏ Learning
๏ Commercial
๏ Problem Solving
๏ Other

19. Types of OSS Projects
๏ Microlibraries (“left-pad”, etc)
๏ Libraries (jQuery, Bootstrap, React, etc)
๏ Languages (PHP, Swift, etc)
๏ Databases (Mongo, MySQL, etc)
๏ Utilities (Git, Apache, WordPress, etc)
๏ Operating Systems (Linux, Android, etc)
๏ Other?

20. Contributor
Considerations

21. Considerations
๏ Finding a project to contribute to
๏ Picking an issue
๏ The contribution process

22. Up for Grabs

23. Contribution Process
๏ Forking (or by being added to the repository)
๏ Write some code
๏ Test
๏ Submit Pull Request (PR)
๏ Merge

24. Maintainer
Considerations

25. Maintainer Considerations
๏ “Set up the (often ignored) CONTRIBUTING.md
๏ Try hard to organize the code and comment where
necessary
๏ Add an up-for-grabs label (up-for-grabs.net)
๏ Add a githook (using ghooks) that runs the tests
and checks coding standards with eslint so people
don’t have the frustration of going back and forth on
the PR”
Taken from Kent Dodd’s “First Timers Only”

26. Types of Licenses
๏ “Open source licenses grant permission to
everyone to use, modify, and share licensed
software for any purpose, subject to conditions
preserving the provenance and openness of the
software. “
๏ A wide number out there such GPL, MIT, etc
๏ GPL (or “GNU GPLv3”) is one of the most popular
with a strong emphasis on copyleft

27. choosealicense.com

28. Get Tooled Up

29. Git / Github?

30. Let’s review the process
๏ http://www.hongkongjs.com/resources/

31. Pull Requests for
everyone!

32. PR’s for Everyone
๏ Site - http://www.hongkongjs.com/resources/
๏ Repo - https://github.com/hongkongjs/resources
๏ Fork + Add Something + PR

33. Brainstorming

34. Ideas

35. Ideas
๏ Hong Kong Address Lookup
๏ Emergency JS
๏ Profile Wall
๏ FIX Test Server

36. Hong Kong Address Formatting
๏ “Creating some kind of module/component for Hong
Kong standard addresses formatting (with data
being retrieved from Google Maps or, even better,
Open Street Maps). Everyone needs to fill in a HK
address in some forms and I think the lack of proper
formatting could be addressed”

37. Emergency JS
๏ A means of connecting with the Hong Kong JS
community during “JavaScript emergency”

38. Getting Started

39. Getting Started
๏ Note that this is where it gets a bit experimental
๏ Pitch ideas
๏ Decide which project you’d like to join
๏ Create some Github Issues (or equivalent)
๏ Decide who’s going to do what :)

40. Next Steps

41. Next Steps
๏ Lucky Draw!
๏ Collaborate via Slack
๏ Let’s get building!