User-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0) Gecko/20100101 Thunderbird/91.10.0
Thanks for checking/confirming. Repeating from my earlier email:
"I plan to explain the color coding on slide 8 when I get a
chance via speaker notes. The intent of this slide is to map the
contents of the Ambassadors' Jakarta EE 10 contributor guide
(https://jakartaee-ambassadors.io/guide-to-contributing-to-jakarta-ee-10/)
to what actually made it into Jakarta EE 10 and what seems
committed although it did not make it. You could think of it as a
score card of sorts.
The items in dark green are the things that made it into Jakarta
EE 10. The items in light green are the things that looks like
they are going to happen but just did not make it into Jakarta EE
10. The items in black are important gaps that really have not
been addressed yet to my knowledge. I considered putting these
items in light red, but I think readability really suffers if I
did that. I tried different color schemes but I think this is the
best I could figure without complicating the slide any more with
animations, etc."
Good point on some of the CDI deprecation. Let me see how I can
add them.
On 6/9/22 12:11 PM, arjan tijms wrote:
Hi,
On Slide 8
@Lock and @MaxConcurrency didn't make it in. @RolesAllowed
and @RunAs again fell off the wagon as well. JWT
alignment (quite unfortunately really) wasn't done either.
Deprecation/removal could add deprecated CDI methods.
Maybe it wasn't updated? As the other slides talking
about security and concurrency indeed don't discuss these. Or
is slide 8 just about what was intended to be done?
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.
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.