Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [] [jakartaee-ambassadors] Re: Jakarta EE 10 Deck


I liked the following resources for some overview:


Kind regards,
Arjan Tijms

On Thu, Jun 9, 2022 at 3:11 PM Ivar Grimstad <ivar.grimstad@xxxxxxxxxxxxxxxxxxxxxx> wrote:

On Thu, Jun 9, 2022 at 1:49 PM Reza Rahman <reza_rahman@xxxxxxxxx> wrote:

With all respect, I think it's important to look at this from the standpoint of someone that doesn't have a lot of time to be abreast of all specification development. So far, the only way to understand what changed is essentially to navigate each specification document and see if the exact delta is well-documented somehow. Sometimes it is and sometimes it is not (I would assess the quality of this information currently at something like 50%). If you like I can go over it again and list the specific rough spots that are very hard to track down.

Right, documentation is always the hardest part of an open-source project. The Jakarta EE Specification Committee defines the documentation structure, but it is entirely up to each one of the individual open-source specification projects to provide the actual text. There is no central entity providing this service. 
Documentation is probably one of the most appreciated contributions that can be made to an open-source project. The more help, the better documentation.


In the meanwhile, if folks could do an old fashioned review, I would really appreciate it. I do need to deliver this talk as soon as a few weeks from now.

On 6/9/2022 6:27 AM, Ivar Grimstad wrote:
Hi Reza,

Thanks for setting this up! 
As I promised, I will send you the rest of my slides when they have been updated so you can add them to the ones you got previously.

You say it is hard to find the information, which makes me curious. What is missing on the specification pages [1]? 
The goal is that these pages should be a one-stop place to find all information about the various specification releases.

Note that the Specification Committee is currently going over each specification to add a "Short Summary" section modeled after this template [2].
This work is not complete yet, so bear with us a little until we get it done. An example of what it may look like is Jakarta Connectors 2.1 [3].

Each specification document contains a "What's new" section and a changelog, and we don't want to duplicate too much of this information on the summary page. 
Just the key features of the release.

Hope this helps!


On Thu, Jun 9, 2022 at 5:38 AM Reza Rahman <reza_rahman@xxxxxxxxx> wrote:
Hi folks,

I am beginning to put together my Jakarta EE 10 deck:!AlSoTwbDM7bzgeYG6M4aS_Mi2Pbemg?e=uc6ccj. I have to
be honest that this was very tough as accurate and complete information
on Jakarta EE 10 has been very difficult to come by at the moment.

Can I kindly ask for a review? At this point, 100% accuracy and
completeness is probably not possible but I would like to avoid obvious

Once I have delivered the talk a few times, I will add a heavy amount of
speaker notes, record the talk and make it possible for any Ambassador
to deliver the talk themselves.

Thanks in advance for your help.

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.

_______________________________________________ mailing list
To unsubscribe from this list, visit


Ivar Grimstad

Jakarta EE Developer Advocate | Eclipse Foundation Eclipse Foundation - Community. Code. Collaboration. 

_______________________________________________ mailing list
To unsubscribe from this list, visit
_______________________________________________ mailing list
To unsubscribe from this list, visit


Ivar Grimstad

Jakarta EE Developer Advocate | Eclipse Foundation Eclipse Foundation - Community. Code. Collaboration. 

You received this message because you are subscribed to the Google Groups "Jakarta EE Ambassadors" group.
To unsubscribe from this group and stop receiving emails from it, send an email to jakartaee-ambassadors+unsubscribe@xxxxxxxxxxxxxxxx.
To view this discussion on the web visit

Back to the top