Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF
On Fri, Sep 13, 2019 at 12:55 PM Guillermo González de Agüero <z06.guillermo@xxxxxxxxx> wrote:
Here is the one for Jakarta REST: https://jakarta.ee/specifications/restful-ws/2.1/

Thank you for providing this link. 

Why isn't there a line to https://jakarta.ee/specifications/ on Jakarta EE home page? I spent a good deal of time looking for these docs today. The Specifications page does not show up on the the first page of a Jakarta home page search for "restful web services". An overview page comes up (https://projects.eclipse.org/projects/ee4j.jaxrs) butI see no link on it to a spec, and nothing in the download page.
 
The content of those pages is stored at https://github.com/jakartaee/specifications

As you can see, it's the equivalent to the JSR pages at jcp.org

El vie., 13 sept. 2019 18:47, Markus KARG <markus@xxxxxxxxxxxxxxx> escribió:

Since when does *each* spec have a jakarta.ee page? Where is REST's, and who maintains that conent and where?

-Markus

 

Von: jakarta.ee-community-bounces@xxxxxxxxxxx [mailto:jakarta.ee-community-bounces@xxxxxxxxxxx] Im Auftrag von Guillermo González de Agüero
Gesendet: Freitag, 13. September 2019 11:07
An: Jakara EE community discussions
Betreff: Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF

 

Just for clarification, with "specification pages" I meant the jakarta.ee page of each spec.

 

El vie., 13 sept. 2019 7:37, Markus KARG <markus@xxxxxxxxxxxxxxx> escribió:

This is what we had in Jakarta REST, and Bill explicitly requested us to remove exact that line from our boilerplate PDF.

-Markus

 

 

Von: jakarta.ee-community-bounces@xxxxxxxxxxx [mailto:jakarta.ee-community-bounces@xxxxxxxxxxx] Im Auftrag von Guillermo González de Agüero
Gesendet: Donnerstag, 12. September 2019 20:31
An: Jakarta EE community discussions
Betreff: Re: [jakarta.ee-community] Jakarta EE 8 Specs in PDF

 

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@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

_______________________________________________
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


--
"Hell hath no limits, nor is circumscrib'd In one self-place; but where we are is hell, And where hell is, there must we ever be" --Christopher Marlowe, Doctor Faustus (v. 111-13)

Back to the top