Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakartaee-platform-dev] Spec doc conversion: heads-up

Hi Bill,

Regarding your message https://www.eclipse.org/lists/jakartaee-platform-dev/msg01545.html - I would ask if it is fine from a legal / IP point of view to copy text from the 1.3 version of the spec even though only the 1.2 version was contributed via ipzilla?

Thanks,
Tom

On Mon, 17 Feb 2020 at 10:53, Tom Jenkinson <tom.jenkinson@xxxxxxxxxx> wrote:
Thanks Bill, the spec document for 1.3 does exist over here https://www.jcp.org/en/jsr/detail?id=907 and https://github.com/javaee/jta-spec and it seems to have some changes so it's not clear to me why we would not use that as the source of the Jakarta version?

Just from a visual inspection of the PDF I can see 1.3 seems to at least have changed a reference of EJB servers to Java EE servers and added some data related to Java SE providing the .xa package.

(I would note that although 1.3 talks about .xa being in the Java SE packages there are sections that refer to how to implement some of those [3.4 and 3.5] which might be better to move to a relevant Java SE specification - however that might be as well to discuss with the JTA list once we have clarity on what spec version we are using).

On Sat, 15 Feb 2020 at 01:09, Bill Shannon <bill.shannon@xxxxxxxxxx> wrote:
I'm sure by now you know the history of JTA 1.3.

I suspect we didn't update the spec document for version 1.3, we just submitted the MR materials.

Tom Jenkinson wrote on 2/14/20 4:31 AM:
Thanks for the info.

I am going to assume we don't check in the target folder in the zip.

However I have a another problem. https://dev.eclipse.org/ipzilla/show_bug.cgi?id=21456 appears to contain version 1.2 of the specification rather than 1.3?

On Wed, 12 Feb 2020 at 14:06, Kevin Sutter <kwsutter@xxxxxxxxx> wrote:
Tom,
I should have read the passage before responding...  The doc already states that only "checkin" is required before starting work on the doc.  The "Approval" is required before the doc can be included in a public release (or service release).  Any Milestone or Release Candidate drivers are okay to include the doc before these CQs are approved.  If you look at the complete list of CQs, you'll see about half of them are in the Approved state.  This is a state at the IP team moves the CQ to -- after the development team has updated the CQ with the information that the source has been merged and any requested actions have been taken care of.


Hope this helps!
-- Kevin

On Wed, Feb 12, 2020 at 7:57 AM Kevin Sutter <kwsutter@xxxxxxxxx> wrote:
That is not correct, Tom.  The CQ gets marked Approved after each component does the required work to incorporate the source into their repo.  The keyword "checkin" is required as well as PMC approval.  I'll update those instructions.  Thanks!

-- Kevin

On Wed, Feb 12, 2020 at 5:06 AM Tom Jenkinson <tom.jenkinson@xxxxxxxxxx> wrote:
Hi,

https://github.com/jakartaee/specification-committee/blob/master/steps_javaee_to_jakartaee.adoc says "CQ must be marked approved before the document may be included in any release". I tried to find something on https://dev.eclipse.org/ipzilla/show_bug.cgi?id=21456 to confirm it but don't have an exact match. Is the thing to look for a positive PMC_Approved flag?

Also I see a keyword "checkin" but how do I the person that set it is part of the "EMO IP Team"? https://dev.eclipse.org/ipzilla/show_activity.cgi?id=21456

Thanks,
Tom

On Wed, 22 Jan 2020 at 14:43, Kevin Sutter <sutter@xxxxxxxxxx> wrote:
Just to ensure that everyone knows about this...  Based on our efforts for the Platform and Web Profile Specs, we compiled some helpful hints.  I just referenced these when I did the Jakarta-izing of the Managed Beans Spec and it helped jog my memory.  Good luck!

https://github.com/jakartaee/specification-committee/blob/master/steps_javaee_to_jakartaee.adoc

---------------------------------------------------
Kevin Sutter
STSM, MicroProfile and Jakarta EE architect @ IBM
e-mail:  sutter@xxxxxxxxxx     Twitter:  @kwsutter
phone: tl-553-3620 (office), 507-253-3620 (office)    
LinkedIn:
https://www.linkedin.com/in/kevinwsutter



From:        Mark Thomas <markt@xxxxxxxxxx>
To:        jakartaee-platform-dev@xxxxxxxxxxx
Date:        01/22/2020 08:29
Subject:        [EXTERNAL] Re: [jakartaee-platform-dev] Spec doc conversion: heads-up
Sent by:        jakartaee-platform-dev-bounces@xxxxxxxxxxx




On 22/01/2020 11:54, Dmitry Kornilov wrote:
> I am currently working on JPA spec and facing the same issues. It’s not difficult, but time consuming because there is no other way than doing it manually section by section.

+1

Also, from experience of doing the EL and WebSocket specs watch for
escaping issues around code snippets.

I found there was a reasonable amount that could be done via search and
replace on the source but you have to review each one. You can't just do
a global search and replace.

And there was no getting away from the repeated cycles of generate PDF,
proof-read, correct, repeat.

Mark


>
> - Dmitry
>
>> On 22 Jan 2020, at 12:42, arjan tijms <arjan.tijms@xxxxxxxxx> wrote:
>>
>> Hi,
>>
>> I just started with the JASPIC to Jakarta Authentication spec document conversion, and just a heads-up for anyone who hasn't started yet: it's quite labour intensive.
>>
>> Tables are completely missing, image captions are mistaken for headings meaning section numbering and hierarchies are all wrong, even chapter numbering can become all wrong, footnotes are missing, etc etc.
>>
>> This is far more than just a semi-automated search & replace for terms as with the Javadocs adjustments for Jakarta EE 8.
>>
>> Basically it boils down to reading the entire document, adjusting errors wherever you see them, compiling the PDF, checking it's correct now and repeat that.
>>
>> Absolutely doable of course, but just taking a fair amount of time.
>>
>> Kind regards,
>> Arjan
>>
>> _______________________________________________
>> jakartaee-platform-dev mailing list
>> jakartaee-platform-dev@xxxxxxxxxxx
>> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
>>
https://www.eclipse.org/mailman/listinfo/jakartaee-platform-dev
>
> _______________________________________________
> jakartaee-platform-dev mailing list
> jakartaee-platform-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
>
https://www.eclipse.org/mailman/listinfo/jakartaee-platform-dev
>

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



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

_______________________________________________
jakartaee-platform-dev mailing list
jakartaee-platform-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://urldefense.com/v3/__https://www.eclipse.org/mailman/listinfo/jakartaee-platform-dev__;!!GqivPVa7Brio!KXkNVsQWgtsdLXHXxtbmcBLNHqIlt_gFXIxgUcGksmESOsmGMuzHs49YDsQhILj5nQ$ 


Back to the top