The problem developers new to open source have is joining the community, starting to contribute, and using common open source tools. In this session, attendees will learn how to contribute and become valuable a part of any open source community. Attendees will learn soft and hard skills based on two case studies: Eclipse MicroProfile and Apache TomEE projects. Attendees will learn to access the culture of open source projects, expected behavior and attitude toward new contributors; how to start small, take risks, ask lots of questions; and how to get started with common open source tools like Maven, Git, and JIRA. Students will leave this workshop the soft skills and the hard skills required to make meaningful contributions.

1. @CesarHgt @tomitribe
César Hernández
It’s Easy! Contributing to Open Source

2. @CesarHgt @tomitribe
Who am I?
César Hernández
● Senior Software Engineer at Tomitribe
● Java Champion & Oracle Groundbreaker
Ambassador
● Duke’s Choice Award 2016, 2017
● Oracle Certified Professional
● +14 experience with Java Enterprise
● Apache TomEE, Eclipse Jakarta Committer,
Contributor for Microprofile.
● Open Source advocate, teacher and public speaker

3. @CesarHgt @tomitribe
What is Open Source?
https://opensource.com/resources/what-open-source
“The term "open source" refers to something people can modify and share
because its design is publicly accessible.”
“Open source software is software with source code that anyone can inspect,
modify, and enhance.”

4. @CesarHgt @tomitribe
Why you should be involved in open source?
● Become a part of a community
○ New friends
○ Networking
○ Recognition
● Skill Enhancement
○ Improving your programming skills
○ Understanding software architecture
○ Deeper knowledge of a specific software domain
○ Experience working on distributed teams

5. @CesarHgt @tomitribe
Why you should be involved in open source
● Experience working with with many different kinds of people
○ Resume and Portfolio Enhancement
○ Reference open source in resume
○ Use GitHub or other repos to show your work
○ Business opportunities (for example: support offering)

6. @CesarHgt @tomitribe
Looking for an expert?

7. @CesarHgt @tomitribe
How open source works?
● Commercial Interests
○ Donating company
○ Sponsor
○ Open Source Support
● Community
○ Types of people involved
○ Social norms

8. @CesarHgt @tomitribe
How open source works?
● Governance
○ Who is in charge?
http://pngimg.com/download/30433

9. @CesarHgt @tomitribe
How open source works?
● Governance
○ Who is in charge?
http://pngimg.com/download/30404

10. @CesarHgt @tomitribe
How open source works?
● Governance
○ What are committers?
https://simpsons.fandom.com/wiki/Benjamin_(nerd)?file=Benjamin,_Doug,_and_Gary.gif

11. @CesarHgt @tomitribe
How open source works?
● Governance
○ How are decisions made?
https://en.wikipedia.org/wiki/File:All_Simpsons_characters.jpg

12. @CesarHgt @tomitribe
How open source works?
● Governance
○ Types of Licenses
82Approved
Licenses
{
MIT
APACHE 2.0
GNU GPL v3.0
Most common
licenses on GitHub
https://choosealicense.com/

13. @CesarHgt @tomitribe
The tools of open source
● GIT and the Forking Workflow
● JIRA and Bugzilla
● Maven and Build Automation tools
● Project Mailing lists
○ user@ vs dev@
● Instant Messaging / Chat
○ IRC
○ Slack
○ Gitter

14. @CesarHgt @tomitribe
The tools of open source
● Video Telecommunication tools
○ Zoom,
○ Hangouts,
○ Skype

15. @CesarHgt @tomitribe
Choosing an open source project
● Programming Language
● Technology Domain
● Leadership and Governance
● Community culture
○ Friendly
○ Fast and Furious
○ Experts only
○ Nasty

16. @CesarHgt @tomitribe
The types of contributions
● Code
● Documentation
● Workshops
● Testing
● Continuous Integration
● Moderator on communication channels
● “ any substantive action that generates content”
https://octoverse.github.com/

17. @CesarHgt @tomitribe
Apache TomEE

18. @CesarHgt @tomitribe
Apache TomEE
● JavaEE certified Apache Tomcat version
● Jakarta EE 9 in progress (formerly Java EE).
● Build from Apache components
● Footprint: 30MB zip, 100~MB memory

19. @CesarHgt @tomitribe
300+
Projects
730+
Members
7k+
Committers
1.058B+
Lines of code
20
Years
All volunteer
community
https://files-dist.s3.amazonaws.com/AnnualReports/FY2019+Annual+Report.pdf

20. @CesarHgt @tomitribe
The Apache way
USER
ContributorContributor
Committer Committer
PMC Chair
BOARD
USER
PMC Chair

21. @CesarHgt @tomitribe
Tooling
● dev and user mailing lists
● JIRA
● Slack
● GITHUB mirror from SVN
○ Pull request model for interaction
tomee.apache.org/community

22. @CesarHgt @tomitribe
Technical prerequisites
● Java SE
● Maven
● Git
● Jakarta EE (Java EE)
● Junit
● Arquillian
● ...

23. @CesarHgt @tomitribe
Contribution types
● Documentation
● Website fixes
● Code tests
● Code examples
● Coverage increase for unit, integration, performance
and static tests
● New features
● Dependencies updates
● Workshops

24. @CesarHgt @tomitribe
https://www.tomitribe.com/blog/its-easy-requesting-and-discovering-jira-tickets-in-tomee/
https://www.tomitribe.com/blog/its-easy-get-the-tomee-source-code-and-join-the-community/

25. @CesarHgt @tomitribe
TomEE Hack Day

26. @CesarHgt @tomitribe
https://www.tomitribe.com/blog/tomee-for-every-day/
TomEE for the Day!

27. @CesarHgt @tomitribe
MicroProfile

28. @CesarHgt @tomitribe
What is MicroProfile?
● http://microprofile.io
● Enterprise Java for MicroServices
● Open Source (Eclipse)
● Implemented by different vendors.
● Application portability across runtimes.

29. @CesarHgt @tomitribe
MicroProfile 3.3
MicroProfile 3.3
JAX-RS 2.1JSON-P 1.1CDI 2.0
Config 1.4
Fault
Tolerance 2.1
JWT
Propagation
1.1
Health 2.2Metrics 2.3
Open
Tracing 1.3
Open API 1.1
= Updated
= No change from last release (MicroProfile 3.3)
= New
Rest Client
1.4
JSON-B 1.0

30. @CesarHgt @tomitribe
Eclipse Foundation
https://www.eclipse.org/membership/documents/eclipse-foundation-overview.pdf
360+
Projects
275+
Members
1550+
Committers
195M+
Lines of code
15
Years
30
Members

31. @CesarHgt @tomitribe
Governance in MicroProfile
● Who is in charge? Eclipse foundation -> top level project
● What are committers? by merit
● How are decisions made?
● Types of licenses

32. @CesarHgt @tomitribe
Tooling
● Google
○ groups
○ Calendar
● Github
○ Issues
○ Wiki
○ Release notes
● Gitter
● Zoom biweekly community
calls

33. @CesarHgt @tomitribe
Technical prerequisites
● Java
● Maven
● Git
● Junit
● ...

34. @CesarHgt @tomitribe
MicroProfile Community

35. @CesarHgt @tomitribe

36. @CesarHgt @tomitribe
Thank you
César Hernández
It’s Easy! Contributing to Open Source