| Re: [jakartaee-examples-dev] [External] : Re: Volunteering for Jakarta Examples |
I think there is always room for improvement in the EE examples
and sample code.
The collection of material is pretty extensive -- and it's evolved over different time periods. Generally, one might start with the "First Cup" tutorial -- this just shows a user how to download and start using Jakarta EE -- From there, a user might want to venture into the Jakarta EE Tutorial -- probably picking and choosing the sections or technologies they have any interest in -- interspersed in these, that user would want to be learning the details of their favorite IDE, and their favorite EE Application Server (e.g. GlassFish Samples and GlassFish product documentation) -- From there, the EE examples are intended to provide specific, targeted use cases and as you've seen, they aren't showing much about a cohesive, complete application. From there, (or perhaps at the same time) something like CargoTracker can be used to show a more complete and modern application -- and there are other example applications can be used to illustrate how to pull a multitude of EE technologies together into a non-trivial application.
The Java EE Samples (what became Jakarta EE Examples) project was
forked and became JavaEE Samples
several years ago and that fork has been evolved beyond what is
included here in the Jakarta EE collection. If these samples are
worth someone's time and effort to expand upon, we might want to
consider if there would be any benefit in trying to merge these
efforts back together. We could open a discussion with the
relevant parties, if you have any interest in pursuing this.
There's no need to stick with GlassFish, or with a particular IDE -- and, it would be great if there was more diversity in these documents but, this is what was inherited and the community hasn't evolved the network of this material much.
As Reza said, we welcome your input.
I'd be happy to help you as well.
-- Ed
Welcome back to the ecosystem Andy!
I think the Jakarta EE Examples need a major overhaul to be far more use-case driven much like the Spring Boot starters.
The current format has a certain use, but honestly it is more helpful to people who are not really newcomers but want to see a certain feature in action. That said, even that could use serious help including better readmes and better index pages.
I am happy to brainstorm and contribute to this if you and others are interested. Maybe we can schedule a call to talk about it?
Lastly, any contribution to Cargo Tracker is most welcome. Here are the current issues: https://github.com/eclipse-ee4j/cargotracker/issues. I lead that project.
Reza Rahman
Jakarta EE Ambassador, Author, Blogger, Speaker
Please note views expressed here are my own as an individual community member and do not reflect the views of my employer.
On 6/24/2021 7:15 PM, Andy Gibson wrote:
Greetings,
I'm a long time Java developer and would like to volunteer some time to J2EE, or Jakarta EE as it is now. I thought I might ease back into it with some work on examples and/or docs. I've previously worked with JPA, CDI, and JSF mostly and blogged quite a bit about it a few years ago (https://www.andygibson.net/blog/tag/java-ee/). I've long been an advocate for J2EE and making it accessible through those blog posts and I'd like to continue that by way of contributing to the Jakarta projects themselves.
I've had a peek through the examples at https://github.com/eclipse-ee4j/jakartaee-examples and also at the cargo app. I have had a look at the issues for the examples project, but most content is getting on for over 2 years old.
My first impressions would be that most of the examples are minimalist, consisting of a couple of classes showing a particular feature, which is OK, it shows people just the bits they need to add to a class to get a feature working. There isn't much accompanying documentation to describe what that feature does or how it can be used. I noticed there is an issue #8 to Describe the JPA examples which might be a good place to start. Most of those issues don't have much info in them so if anyone has thoughts on what they should do, let me know.
I'm also wondered whether there is interest in another larger application which showcases the more modern features of JEE and Java. It could include documenting the features showing why they are used as well as how. I'm looking for a bit of a project to take on, and that might fit the bill, but for now, I can start by working with some of the existing examples or writing any missing one.
If you have any thoughts or ideas on where to start, please chime in!
Cheers,
Andy Gibson
_______________________________________________ jakartaee-examples-dev mailing list jakartaee-examples-dev@xxxxxxxxxxx To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakartaee-examples-dev
_______________________________________________ jakartaee-examples-dev mailing list jakartaee-examples-dev@xxxxxxxxxxx To unsubscribe from this list, visit https://urldefense.com/v3/__https://www.eclipse.org/mailman/listinfo/jakartaee-examples-dev__;!!ACWV5N9M2RV99hQ!fRzfk32o6m92LP3lD8vqgpxJO5ChvDqR5lsGrb58BIA-QMsRukYYjs4lL6OX-Ls$