Ivar,
Thanks for the explanation.
Yes, I would definitely recommend adding explanatory text, preferably with a link to the corresponding Java EE 8 spec.
How it is currently looks very bad to customers who want to find anything from the spec. Our specifications appear broken, and customers are left greatly inconvenienced trying to find the information they
need.
From:
Ivar Grimstad <ivar.grimstad@xxxxxxxxxxxxxxxxxxxxxx>
Date: Tuesday, September 24, 2024 at 9:04 AM
To: cu developer discussions <cu-dev@xxxxxxxxxxx>
Cc: Nathan Rauh <nathan.rauh@xxxxxxxxxx>
Subject: [EXTERNAL] Re: [cu-dev] Concurrency 1.1 spec link ends prematurely after Introduction section
Hi, Yes, it is intentional as it is only a re-release of the Java EE 8 version of the spec under the new Licence for Jakarta EE 8. All these specifications are
like this. I think it was discussed to link to the Java EE 8 version of the spec,
Hi,
Yes, it is intentional as it is only a re-release of the Java EE 8 version of the spec under the new Licence for Jakarta EE 8. All these specifications are like this.
I think it was discussed to link to the Java EE 8 version of the spec, but if I remember correctly that was abandoned to be sure there were absolutely no licensing issues anywhere. Ideally, there should have been some text explaining this
and even pointing to the relevant JSR at jcp.org. But it is what it is.
One thing we could do is add some general explanatory text to the _index.md files for all these specifications. I'll bring it up in the spec committee tomorrow.
A colleague recently notified me that the links to the Jakarta Concurrency 1.1 specification from
https://jakarta.ee/specifications/concurrency/1.1/
only show the first couple of pages of the spec up through the introduction, and otherwise all of the specification content is missing.
This appears to be the case for both the PDF and HTML versions of the spec.
Does anyone know the history behind this and if we are stuck with it that way or if there is a way to correct it?
_______________________________________________
cu-dev mailing list
cu-dev@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/cu-dev
--
Ivar Grimstad
Jakarta EE Developer Advocate |
Eclipse Foundation
Eclipse Foundation - Community. Code.
Collaboration.
|