I did some work in the site generator to add documentation for the TomEE 
9.0.0-M1.

First the results:

 - http://tomee.apache.org/tomee-9.0/pt/examples/
 - http://tomee.apache.org/tomee-9.0/pt/examples/simple-rest.html
 - http://tomee.apache.org/tomee-9.0/examples/schedule-expression.html

 - http://tomee.apache.org/jakartaee-9.0/javadoc/
 - http://tomee.apache.org/jakartaee-9.0/javadoc/jakarta/ejb/SessionBean.html

How this is done under the covers is that we:

 - Add a new "Source" for tomee-9.0 that points to `master` which is still javax
   
https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/Configuration.java#L101

 - Then during processing if the Source is "tomee-9.0" we know it's really a 
clone of `master`:
   
https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/Jakartize.java#L45

 - And we will do a javax-to-jakarta find/replace on all files we've cloned:
   
https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/Jakartize.java#L61-L98

 - Finally, add another new Source for "jakartaee-9.0" that aggregates all the 
right EE4J branches to make javadocs
   
https://github.com/apache/tomee-site-generator/blob/master/src/main/java/org/apache/tomee/website/Configuration.java#L67-L90

That was basically it.

Now we arguably have the largest set of Jakarta examples on the net :)

I'd eventually like to do some more tooling (not related to the site) that we 
can plug into our build and produce a jakarta version of our examples zip.  
Basically, this thing but migrated to the right namespace and completely 
functional:

  - http://archive.apache.org/dist/tomee/tomee-8.0.3/examples-8.0.3-src.zip

Side note, we really need to link that on the download page and also add 
instructions on each example page.  The old CMS version of the examples would 
automatically add instructions on how to checkout the examples source, navigate 
to the right directory and then run the example.  Another feature we really 
need to restore.


-- 
David Blevins
http://twitter.com/dblevins
http://www.tomitribe.com

Attachment: smime.p7s
Description: S/MIME cryptographic signature

Reply via email to