| Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF |
Sadly, no.
Almost no one using Jakarta EE 8 will be unfamiliar with Java EE. This is not really a big problem in practice.
Let's finish updating the tutorial, which will fill much of the gap left by the placeholder specs.
Guillermo González de Agüero wrote on 9/12/19 11:31 AM:
Ok we'll agree the current situation is far from being the best. That said, can't we add some clarification to the specification pages with a link to the JCP?
At least we can add a notice like "WARNING: due to legal reasons, this specification document is just a placeholder. If you need the complete content of the spec, please go to the <JSR PAGE>. For more information about how we needed to do this, click <HERE>".
Would that be acceptable?
Regards,
Guillermo González de Agüero
On Thu, Sep 12, 2019 at 8:16 PM Markus KARG <markus@xxxxxxxxxxxxxxx> wrote:
_______________________________________________As long as the TCK does not check rules laid out by the specs, it is in the best interest of those vendors to certify against these TCKs, because if we fix the TCKs their products would fail. So maybe we should simply make the TCKs completely empty to make more products pass them and have them in sync with the empty PDFs…? ;-) As long as the affected vendors employ the majority of committers and projects leads it is clear that they won't raise such a problem, isn't it? There is a reason why in politics we have such thing like "separation of powers". ;-)
-Markus
Von: jakarta.ee-community-bounces@xxxxxxxxxxx [mailto:jakarta.ee-community-bounces@xxxxxxxxxxx] Im Auftrag von Werner Keil
Gesendet: Donnerstag, 12. September 2019 20:01
An: Jakarta EE community discussions
Betreff: Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF
Steven, Bill and all the others in the Specification Committee know, we had a lot of last-minute discussion around TCKs that were problematic for certain products and implementations, especially Jakarta Faces or JSON Processing. We voted on on solutions to fix that.
No such problem or need to vote was raised for Jakarta REST, so not sure, what the problem is, but it does not seem to harm vendors or their ability to certify against the TCK.
On Thu, Sep 12, 2019 at 7:56 PM Markus KARG <markus@xxxxxxxxxxxxxxx> wrote:
The problem is that now you have a different risk: Incompatible implementations. The reason is simple: The TCKs and APIs do not cover 100% of the rules laid out in the specs, so it now is possible to define an implementation as compliant with a spec, which actually is not. This risk is true at least for Jakarta REST as we already knew upfront of Jakarta EE several inconsistencies among API, TCK, spec and implementations that in fact do exist. We wanted to fix that, but where asked to not do fix it. And as certifications cannot be undone, we now started with a worst-case scenario: Having certified existing products against non-existent rules. Thanks! ;-(
Von: jakarta.ee-community-bounces@xxxxxxxxxxx [mailto:jakarta.ee-community-bounces@xxxxxxxxxxx] Im Auftrag von Steve Millidge (Payara)
Gesendet: Donnerstag, 12. September 2019 10:50
An: Jakarta EE community discussions
Betreff: Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF
There are good legal reasons that the new specifications don’t point to the old specifications as this provides a clean, licensed, stand alone document to begin development from.
In particular the new specifications are under a different license the EFSL https://www.eclipse.org/legal/efsl.php. If they referenced the requirements in the JCP documents then any user of the Jakarta specification would also be required to read the JCP document which has a different “click wrap” license which the user would then be required to accept and comply with. There was then a risk that this would require any Jakarta EE licensee to also become a Java EE licensee.
IANAL
Steve
From: jakarta.ee-community-bounces@xxxxxxxxxxx <jakarta.ee-community-bounces@xxxxxxxxxxx> On Behalf Of Werner Keil
Sent: 12 September 2019 08:49
To: Jakara EE community discussions <jakarta.ee-community@xxxxxxxxxxx>
Subject: Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF
Kevin,
Thanks for the suggestions, I assume it'll help Markus or others in spec projects to point to the old specs till the new ones get beefed up or where they could not for some reason.
Markus,
I also have customers or agencies that still ask for J2EE experience after all these years. ;-)
I stopped trying to correct them, but others who follow trends and new technologies or even try to shape them won't.
We also see too many people who try to errect Confederate statues or deny the Holocaust or Climate Change, we should not make the same mistakes but rather look in the future.
Werner
Kevin Sutter <sutter@xxxxxxxxxx> schrieb am Do., 12. Sep. 2019, 09:07:
Markus,
Until the rest of the Specifications are contributed to Eclipse (soon, I hear...), why not just update your "front page" (wiki, gh pages, README, whatever) to point at the JCP page for background information? This could be a temporary stop gap until the Spec source is made available to you.
Also, Bill's comments (and everybody else on the Spec Committee) on the content of the skeletal specifications was to ensure consistency. If we provided a common template with common, consistent content (project name, scope statement, copyright, license, etc), then Jakarta EE will look and feel like a finished product. If we let every component do their own thing, then it would just look like a hodge-podge of information and would not provide the professional view that we have. You may not agree, and that's fine. But, we were doing this for a reason. Thanks.
---------------------------------------------------
Kevin Sutter
STSM, MicroProfile and Jakarta EE architect
e-mail: sutter@xxxxxxxxxx Twitter: @kwsutter
phone: tl-553-3620 (office), 507-253-3620 (office)
LinkedIn: https://www.linkedin.com/in/kevinwsutter
From: "Markus KARG" <markus@xxxxxxxxxxxxxxx>
To: "'Jakarta EE community discussions'" <jakarta.ee-community@xxxxxxxxxxx>
Date: 09/12/2019 06:20 AM
Subject: [EXTERNAL] Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF
Sent by: jakarta.ee-community-bounces@xxxxxxxxxxx
I know that. The question is, how shall the reader of the Jakarte EE 8 spec know?
Von:Bill Shannon [mailto:bill.shannon@xxxxxxxxxx]
Gesendet: Mittwoch, 11. September 2019 23:08
An: Jakarta EE community discussions; Markus KARG
Betreff: Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF
As Werner said, all the specs are on the JCP web site. You can find a list of all the specs and links to the JSRs on the Java EE Platform web siteor Oracle's Java EE web site.
Markus KARG wrote on 9/11/19 11:06 AM:
Actually it is hard for Jakarte EE 8 spec readers to find the Java EE 8 specs. The reason is that Bill Shannon (IIRC) enforced that existing references form the boilerplate specs to the Java EE specs have to get removed -- so we removed them, at least for JAX-RS. It is rather funny that now you say, people shall read exactly those specs… How shall they locate them?
-Markus
Von:jakarta.ee-community-bounces@xxxxxxxxxxx[mailto:jakarta.ee-community-bounces@xxxxxxxxxxx] Im Auftrag von Kevin Sutter
Gesendet: Mittwoch, 11. September 2019 10:59
An: Jakarta EE community discussions
Betreff: Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF
Arjan is correct. We have complete Specifications for the Platform, Web Profile, CDI, and Bean Validation. The rest of the Components have these skeletal specifications and rely on the Javadoc for Jakarta EE 8. These other Specifications will be filed as they complete their copyright and IP clearances. We decided it was best to go this route instead of waiting for all of the Component specs to clear. Appreciate your patience.
I covered some of these process-related items in my "Jakarta for dummEEs" talk yesterday at the JakartaOne Livestream conference. Replays are available:
https://www.crowdcast.io/e/nztuljys/1
---------------------------------------------------
Kevin Sutter
STSM, MicroProfile and Jakarta EE architect
e-mail: sutter@xxxxxxxxxx Twitter: @kwsutter
phone: tl-553-3620 (office), 507-253-3620 (office)
LinkedIn: https://www.linkedin.com/in/kevinwsutter
From: arjan tijms <arjan.tijms@xxxxxxxxx>
To: Jakarta EE community discussions <jakarta.ee-community@xxxxxxxxxxx>
Date: 09/11/2019 09:34 AM
Subject: [EXTERNAL] Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF
Sent by: jakarta.ee-community-bounces@xxxxxxxxxxx
Hi,
It's "correct" in the sense that the real spec documents haven't been transferred yet. The current ones that are released (most of them) are just the bare minimum. We call them boilerplate specs.
We expect that sometime in the future the existing Java EE spec documents or a subset of those will be transferred.
Kind regards,
Arjan
On Wed, Sep 11, 2019 at 4:30 PM Gregor Kovač <kovica@xxxxxxxxx> wrote:
Hi!
Specs are available at https://jakarta.ee/specifications/
"Jakarta EE Platform 8" has 242 pages, but "Jakarta Enterprise Beans 3.2" has only 5 pages. Am I missing something? Looking in a wrong place, ... ?
Best regards,
Kovi_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community
_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxxTo change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community
_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community
_______________________________________________ jakarta.ee-community mailing list jakarta.ee-community@xxxxxxxxxxx To change your delivery options, retrieve your password, or unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community