Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakarta.ee-community] [jakartaee-ambassadors] Re: Jakarta EE 10 Deck

Yep, looked at all these. Unfortunately was unsure of their accuracy and completeness too (which is why I tried to also look at the specification documents themselves in addition to what Ivar managed to get for me).

Thanks for pointing these out though.

On 6/9/22 12:04 PM, arjan tijms wrote:
Hi,

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.

Ivar
 

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!

Ivar


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:
https://1drv.ms/p/s!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
mistakes.

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.

_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community


--

Ivar Grimstad

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


_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community
_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community


--

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 https://groups.google.com/d/msgid/jakartaee-ambassadors/CA%2BTrRF%2B1JarVEvn69g4oTaBQg%3Dc0r7TGsTe1PGN1HJVoCRjdbg%40mail.gmail.com.

_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

Back to the top