Converted to plain AsciiDoc

[ggam]

This PR converts the whole tutorial to plain AsciiDoc without JBake. The result can be seen at http://www.ggam.eu/jakartaee-tutorial/

I haven't made any content changes besides removing duplicated titles that weren't needed anymore. To the best of my knowledge, all links and images are still working and this PR is in a mergeable state.

This makes the tutorial easier to maintain and provides a more modern look.

Things I've made:

• Reorganized files in folders. Once the content is updated for Jakarta EE 9, old stuff can be deleted or moved to a "Legacy stuff" category.
• Replaced setext headings with the recommended atx (https://asciidoctor.org/docs/asciidoc-recommended-practices/#section-titles)
• Removed handcrafted tables of contents.
• Enabled syntax highlighting.
• Updating Maven dependencies and cleaning up pom. Now compiles on Java 14.
• Fixed AsciiDoctor warnings and errors. This affected some nested lists.

Closes:

• It is not possible to see table of contents and documentation at the same time. #187
• Syntax highlighting #124
• broken links  #188
• Markup typo's in overview008.adoc #190

And makes it straightforward to solve #129.

[ggam]

I know everyone's busy with Jakarta EE 9 work, but could someone please take a look and approve this? I'd like to see this landing to master before I continue working on it.

[ivargrimstad]

I have no way the bandwidth to review 1005 files, but I trust you when you say that no content has changed and the reorganizing looks excellent to me. Thanks!

[ggam]

Thanks Ivar! One more approver and we could merge this please?

[ggam]

@keilw since you are around, would you please have a look at this?

[keilw]

This is really massive, but if it works for you @ggam this looks like the only PR that has no IP problem, so I have a look and might merge it this evening.

[ggam]

Thanks @keilw. I'm aware this is a very big PR and I understand the tutorial is noone's priority right now, but this is needed before moving forward.. #193 (draft) only adds some changes on top of this one.

[ggam]

Thanks! El mar., 30 jun. 2020 9:57, Ivar Grimstad <notifications@github.com> escribió:

…

Merged #191 <#191> into master. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#191 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAQC44AXCE4S57AXLC53NKTRZGLFLANCNFSM4MQMPHDQ> .

[keilw]

I saw @ivargrimstad already merged it, thanks.