jakartaee-tutorial icon indicating copy to clipboard operation
jakartaee-tutorial copied to clipboard

Provide multi online version for different Jakarta EE version?

Open hantsy opened this issue 3 years ago • 3 comments

I think it is better to provide multi versions for different Jakarta EE versions.

Such as

  • http://xxx/index.html like the Jakarta EE spec on Jakarta.ee, provide an index page for all maintained versions.
  • http://xxx/8/index.html for Jakarta EE 8
  • http://xxx/9/index.html for Jakarta EE 9 and Jakarta EE 9.1
  • http://xxx/current/index.html for the latest development version

hantsy avatar May 09 '21 15:05 hantsy

+1, I was just thinking exactly the same ;)

arjantijms avatar May 09 '21 15:05 arjantijms

Yes indeed, it has a Draft 9 already, but either accept that http://xxx/8/index.html for Jakarta EE 8 would be this project's 8.1 release or it would have to be http://xxx/8.1/index.html instead? I just tagged the examples with a matching 8.1 release tag so they are in sync although I am not sure, if the examples are even built right now?

keilw avatar May 09 '21 15:05 keilw

Yes. Considering that older versions of Jakarta EE are still widely used, it makes sense to host online copies of tutorials for the older versions of Jakarta EE. Failing that, the older tutorials should be provided as a ZIP file download for offline usage.

For example, Oracle is still hosting the documentation (including tutorials) for old versions of Java EE:

  • Java EE 7: https://docs.oracle.com/javaee/7/
  • Java EE 6: https://docs.oracle.com/javaee/6/
  • Java EE 5: https://docs.oracle.com/javaee/5/

Jakarta EE should do the same.

flux77 avatar Aug 24 '22 05:08 flux77