Jumping in Jakarta Open Source Project Everything nobody tells you

1. Jumping in Jakarta Open Source Project
Everything nobody tells you

2. Speaker
Roan Brasil
@roanbrasil
Senior Engineer
+ JCP-Member
+ Open Source Contributor
+ Book and blog writer
+ Teacher

3. What is open source software?

4. Licenses Type - GNU General Public License
● Freedom
○ Execute the program
○ Study and change the
source code
○ Share modified versions
○ Share copies
● Allows easy access to the
source code
● Allows BitTorrent
● Strong Copyleft
● Adopted in the Kernel Linux
● Commercial use
https://www.gnu.org/licenses/gpl-3.0.en.html

5. Copyright vs Copyleft

6. Licenses Type - Eclipse Public License (EPL)
● Current EPL-2.0
● Contributor can opt in a
secondary license
● Weaker copyleft
● Based on COmmon Public
License CPL
● Listed at Free Software
Foundation FSF and Open
Source Initiative OSI
● Commercial Use
● Distribution
● Modification
https://www.eclipse.org/legal/epl-2.0/

7. What is Jakarta EE?
É um conjunto de especificação que permite a comunidade de java developers na
grande rede de computadores trabalhar em java enterprise applications. As
especificações são desenvolvidas por pessoas bem conhecidos como líderes na
indústria, isso inspira confiança em desenvolvedores e consumidores de tecnologia
devido a grande credibilidade e seriedade de quem está por trás do projeto.
https://jakarta.ee/about/

8. How Open Source Coding can help in your career
1. Learn how to work as a team
2. Working complex application
3. Get constantly feedbacks
4. Community and Networking
5. Build a good reputation on Internet
6. Companies like Open Source Contribution

9. How to contribute in the Jakarta Projects
1. Follow the "main list"
2. Using and reporting Bugs
3. Suggesting feature
4. Documentation
5. Advocate
6. Code

11. How to start to contribute?
● Register an user in https://www.eclipse.org/org/workinggroups/

12. How to start to contribute?

13. How to start to contribute?

14. How to start to contribute?

15. How to start to contribute?

16. How to start to contribute?
● Choose a project

17. How to start to contribute?
● Choose start by documentation because always the FIRST COMMIT is hard.

18. How to start to contribute?
● You are going to need to sign and agree with a My Eclipse Contributor Agreement
in Eclipse Foundation home page. Without that you cannot open a PR. In my case I
access the link: https://accounts.eclipse.org/users/{{myUser}}/eca. You need to feel all
the information and agree with the term updating the ECA.

19. How to start to contribute?

20. How to start to contribute?
Check out all box in this terms and fill all fields. In the end, once you finish click in the
Green Button — Update ECA. Voilà, we are able to do your first commit.

21. How to start to contribute?
Show a remote show origin using the command git remote show origin .

22. How to start to contribute?
run the command git remote add external
https://github.com/eclipse-ee4j/nosql.git
run the command git remote show that shows you you do not have just origin
anymore, you also have remote recently created.

23. How to start to contribute?
run the command git fetch external to fetch the branchs

24. How to start to contribute?
Synchronize everything with the command git merge external/master

25. How to start to contribute?
Create a new branch running the command git checkout -b [your-branch-name]
In my case, my first change was in this file ->
spec/src/main/asciidoc/annotations.adoc
git add spec/src/main/asciidoc/annotations.adoc

26. How to start to contribute?
This is the most important step, do not miss this, if you forget to run exactly like here
you can have a problem with you PR. In this step you need to sign your commit, as the
eclipse foundation defines this, you need to run this command git commit — amend
— signoff and is going to open a vi interface to edit comments. If you are not familiar
with VI, type the letter i to insert some content and the key in the keyboard esc to quit
edition mode. If you want to save your content, you need to press esc to quit the edition
mode, after :wq . This command allows you to write and quit from VI interface. But
make sure you have your signoff: Signed-off-by: Your-Full-Name
<your-email@email.com>

27. How to start to contribute?
Run the command to push your changes git push — set-upstream
[your-branch-name] .

28. How to start to contribute?
Create a New Pull Request

29. How to start to contribute?

30. How to start to contribute?

31. References:
● https://www.eclipse.org/projects/dev_process/
● https://wiki.eclipse.org/Development_Resources/Contributing_via_Git#Signing_off_o
n_a_commit
● https://wiki.eclipse.org/Development_Resources/Handling_Git_Contributions
● https://www.eclipse.org/contribute/
● https://medium.com/@roanmonteiro/jumping-in-open-source-project-everything-no
body-tells-you-using-command-line-f1376303c0d5

32. Q & A: