Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakartaee-tck-dev] [jakarta.ee-spec.committee] TCK User Guide review

I have submitted another PR [1] that updates all the remaining templated Must Have spec user guides. This leaves Jakarta EE (CTS) user guide. This one doesn't use the template and will need direct edits. If we can get all the "WARNING" admonishments in the template resolved, these could all be ready to go for ballot. I would, of course welcome comments on the individual user guides as well.

Hopefully, someone will approve my new PR so I can merge it. And, more of you will find time to read the text and help us tidy it all up.

Thanks,

-- Ed


[1]  - https://github.com/eclipse-ee4j/jakartaee-tck/pull/77

On 7/12/2019 4:07 PM, Bill Shannon wrote:
Ed has been updating the TCK User Guide template and many of the
individual User Guides derived from that template.  He just merged
a bunch of changes [1], which I've started to review, but it would be
even better if more of you could review them as well.

For your convenience, I've attached a pdf version of the latest template.
Please review it and provide feedback.

To get you started, here's just one specific paragraph in the preface
for which we would like feedback:


Jakarta EE is a community sponsored and community run program.
Organizations contribute, along side individual contributors who use,
evolve and assist others. Commercial support is not available through
the Eclipse Foundation resources. Please refer to the Eclipse EE4J
project site (https://projects.eclipse.org/projects/ee4j). There, you
will find additional details as well as a list of all the associated
sub-projects (Implementations and APIs), that make up Jakarta EE and
define these specifications. If you have questions about this
Specification you may send inquiries to wombat-dev@xxxxxxxxxxx. If you
have questions about this TCK, you may send inquiries to
jakartaee-tck-dev@xxxxxxxxxxx.

And here's another from the introduction:


The Jakarta EE Specification Process (JESP) program is the
formalization of the open process that has been used since 2019 to
develop and revise Jakarta EE technology specifications in cooperation
with the international Jakarta EE community. The JESP program specifies
that the following three major components must be included as
deliverables in a final Jakarta EE technology release under the
direction of the responsible Expert Group:

    Technology Specification

    Compatible Implementation (CI)

    Technology Compatibility Kit (TCK)

For further information about the JESP program, go to Jakarta EE
Specification Process community page TBD (https://jakarta.ee).

Comments encouraged!

One of the big items still to be done is to replace the JSR references
with references to the specs on the jakarta.ee web site.  We'll be working
on that soon.

Thanks for your help!


[1] https://github.com/eclipse-ee4j/jakartaee-tck/pull/76


_______________________________________________
jakarta.ee-spec.committee mailing list
jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee

Back to the top