[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [jakartaee-platform-dev] Spec doc conversion: heads-up
|
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.
- 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