As of Java 7, the OpenJDK is the Reference Implementation (RI) for Java. In essence, the OpenJDK is the Java we use every day! With legal and technical barriers become smaller every day, it is now more possible than ever to get involved in the language and VM that we all love.
The Adopt OpenJDK program has a number of goals:
- Encouraging members of JUGs to get involved in the OpenJDK
- Improving the language and the VM which we use daily!
- To promote the OpenJDK in the wider Java community
- Broaden the base of contributors to the OpenJDK
Benefits for you
You learn about F/OSS technology, unit testing, and contributing to large source code projects. You also get some other benefits:
- Participate in a community event
- Add your name to the list of Java contributors
- Learn new massive project management skills
- Learn unit and regression testing (jtreg)
- Add it to your list of Fu skills (resume/CV)
- Drink beverages and eat food with cool people
- Get a t-shirt :-)
Who's Adopting OpenJDK?
- The LJC - (London UK)
- Greenville JUG - (USA)
- SouJava (Brazil)
- JavaBahia (Brazil)
- Several individuals from outside of the JUG program
An overall guideline for this program is that we want to gather up the enthusiasm and skill sets of Java developers around the world, but then focus their efforts at specific areas within the OpenJDK. For example, this means that we'll encourage most Adopt OpenJDK members to tackle library level and/or low hanging fruit categories of changes (we acknowledge that we're not all language designers). A smaller number of JUG members who are really qualified in the area of library design, hotspot internals etc (if you think syntax is the important bit, then this probably isn't you) will be encouraged to contribute in more advanced areas. This of course includes enthusiasts who are willing to put in the time to really learn about this stuff. As Yara from SouJava pointed out at Devoxx, this is a great opportunity to also mentor budding experts in the various parts of the OpenJDK, so that there is a path for those who want to travel it!
You can participate in the program via:
- Google group: Adopt OpenJDK Google Group
- Mailing the Adopt OpenJDK group directly
- IRC: #adoptopenjdk channel on irc.freenode.net
- Follow the #adoptopenjdk hash tag on twitter
Mailing List and IRC Channel rules
Adopt OpenJDK Etiquette
Any time you need help please mail the Adopt OpenJDK group or if that fails the JUG leaders list.
There are a couple of steps you should take if you are going to contribute to the OpenJDK
- Mandatory - Read up on How to Contribute to the Open JDK
- Mandatory/Optional - Sign the Oracle Contributors License Agreement (OCA) (PDF) if you're submitting any work that contains any sort of substantial IP (this isn't required for something as simple as fixing a javac compiler warnings).
Get a project sponsor
In order to have any serious amounts of work approved into the OpenJDK there's also the matter of liaising with a very busy OpenJDK team. Please ensure that you have an OpenJDK project sponsor for the work that you're doing. Typically you can email the Adopt OpenJDK group to get one arranged.
How you could organise yourselves
Again, we don't want to overwhelm the OpenJDK committers! So when organising a workshop/hackday we strongly recommend the following process:
- Nominate some instructors to lead the group. These should be people who have gone through the instructor training and/or are familiar with the OpenJDK build and patch submission processes.
- Don't have qualified instructors?
- Contact the Adopt OpenJDK group and one will be provided for you.
- Further training will also be provided so that you can grow your own instructors.
- Have members join the adoptopenjdk IRC channel irc.freenode.net
- Follow the process outlined for each particular event with regards to fixes, patch creation and review
- This will include co-ordinating with the OpenJDK project sponsor to get the patches in
Levels of contribution
This section covers the myriad ways in which you can contribute to the Adopt OpenJDK program
Your own build
Evangelism, Testing & Triage
Bug fixes and small enhancements
There are some General Instructions for Small Changes which apply to most of the sub projects below.
Jigsaw and OSGi
There are two parts to this. Project Jigsaw itself and project Penrose, a splinter project investigating OSGi/Jigsaw interaction
- Jigsaw - TBA
- Project Penrose - Lead by Neil Bartlett
jtreg, JUnit, TestNG etc
Other JDK Enhancement Proposals (JEPs)
Read Alex Blewitt's blog post for some background information on the JEP process. Some JEPs can be classed as intermediate level proposals:
- Finding and eliminating memory leaks. JDK provides good tools for that, 3rd-party profilers are also helpful
- New platforms support. They can include operating systems, hardware, browsers, window managers - everything. Sometimes the fix is small, sometimes it makes sense to request a new OpenJDK project (e.g. BSD port, or PowerPC/AIX port)
- Performance. It's a never-ending task.
See Javadoc for details - Lead by Ben Evans and Richard Warburton
Build and CI
- Investigate the experimental patch by Lukas Stadler and get it up to date with OpenJDK 8 - Join co_jsrATsswDOTuni-linzDOTacDOTat for details
- Start discussions within mlvm-dev about coroutines, their state and their suitability going forward for the JVM
Other JDK Enhancement Proposals (JEPs)
Read Alex Blewitt's blog post for some background information on the JEP process. Some JEPs can be classed as advanced level proposals:
- Ux overhaul of the http://openjdk.java.net - This is delayed until an infrastructure move takes place.
- Triage OpenJDK Bugs - This is delayed until the public JIRA instance is available