search

jakartaee / specification-committee

Documentation base for Specification Committee guides and process to be published at jakarta.ee via Hugo and git submodules
Eclipse Public License 2.0
8 stars 22 forks source link

Link to relevant JSR from Jakarta EE 8 spec pages #81

Open ivargrimstad opened 2 months ago

ivargrimstad commented 2 months ago

Background

Our Jakarta EE specification documents are just title pages and license information. This was intentional since they are just a re-release of Java EE 8 under the new license.

From time to time, I get the question whether these documents are broken in any way.

Proposed solution

Add a general text on each relevant specification page (the _index.md file for the version) with a link to the corresponding JSR.

Something like:

"This specification is a re-release of JSR-xxx under the EFSL. Refer to JSR-xxx under the JCP for details."

kazumura commented 2 months ago

Our Jakarta EE specification documents are just title pages and license information.

What are exactly "Jakarta EE specification documents" ? Could you give an example URL?

ivargrimstad commented 2 months ago

Our Jakarta EE specification documents are just title pages and license information.

What are exactly "Jakarta EE specification documents" ? Could you give an example URL?

Yes, here is an example:

The specification page: https://jakarta.ee/specifications/concurrency/1.1/

The specification document: https://jakarta.ee/specifications/concurrency/1.1/concurrency-spec-1.1.pdf

ivargrimstad commented 1 month ago

Action: Check internally at Eclipse Foundation if there are any issues with this approach