cool . then the code for JavaDocs.java would look like this:
https://github.com/apache/tomee-site-generator/blob/a96d23581868abff30270115b113df7292872e8b/src/main/java/org/apache/tomee/website/Examples.java assign this task to me, which I try to do : ) thanks . -- *Daniel Dias dos Santos* Java Developer SouJava & JCP Member GitHub: https://github.com/Daniel-Dos Linkedin: www.linkedin.com/in/danieldiasjava Twitter: http://twitter.com/danieldiasjava Em dom, 9 de dez de 2018 às 21:17, David Blevins <david.blev...@gmail.com> escreveu: > The simplest task is to complete the Javadocs class I stubbed out: > > - > https://github.com/apache/tomee-site-generator/blob/a96d23581868abff30270115b113df7292872e8b/src/main/java/org/apache/tomee/website/Javadocs.java > https://issues.apache.org/jira/browse/TOMEE-2342 Publish Javadocs > > Give it a read and see if you have any questions. > > Bottom line goal of that one is one huge chunk of javadoc made from all > src/main/java/ contents combined. > > > -- > David Blevins > http://twitter.com/dblevins > http://www.tomitribe.com > > > On Dec 9, 2018, at 2:35 PM, Daniel Dias Dos Santos < > daniel.dias.analist...@gmail.com> wrote: > > > > now I'm lost in what I have to do David. : ) > > -- > > > > *Daniel Dias dos Santos* > > Java Developer > > SouJava & JCP Member > > GitHub: https://github.com/Daniel-Dos > > Linkedin: www.linkedin.com/in/danieldiasjava > > Twitter: http://twitter.com/danieldiasjava > > > > > > Em dom, 9 de dez de 2018 às 20:28, David Blevins < > david.blev...@gmail.com> > > escreveu: > > > >>> On Dec 9, 2018, at 2:10 PM, Daniel Dias Dos Santos < > >> daniel.dias.analist...@gmail.com> wrote: > >>> > >>> basically I would have to move the comments of: > >>> > >>> - > >> > https://github.com/apache/tomee/blob/master/container/openejb-core/src/main/resources/META-INF/org.apache.openejb/service-jar.xml#L150 > >>> > >>> and add the same ones here : > >>> > >>> - > >> > https://github.com/apache/tomee/blob/master/container/openejb-core/src/main/java/org/apache/openejb/core/stateless/StatelessContainerFactory.java#L105 > >>> > >>> , only in the format of asciidoc . > >> > >> That's one idea of the benefits of using Asciidoc in our Javadoc. The > >> service-jar.xml specifically has been in the project for a long time, so > >> it'd be great to hear more thoughts. > >> > >> However the general idea, which is bigger than service-jar.xml, is that > >> the more we're pushing good documentation into the source code, the more > >> opportunities we have to use it to feed docs on the website. Since the > >> website documentation is primarily Asciidoc, lining that up with our > >> Javadoc could be very smart. > >> > >> We don't necessarily have to switch the comments in the service-jar.xml > >> over as a first step. The first step could be to simply start writing > >> Javadoc for classes that don't have them. > >> > >>> so for this for example, you would also have to convert to asciidoc: > >>> > >>> > >> > https://github.com/apache/tomee/blob/master/container/openejb-jee/src/main/java/org/apache/openejb/jee/AbsoluteOrdering.java#L27L44 > >> > >> In my opinion, the JAXB-generated Javadoc is of low to no value and > could > >> just be deleted. > >> > >> > >> -David > >> > >> > >
