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!
Thomas <markt@xxxxxxxxxx> To:
Re: [jakartaee-platform-dev] Spec doc conversion: heads-up Sent
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.
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.
> > - 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 >