kriegaex opened a new pull request, #138:
URL: https://github.com/apache/xalan-java/pull/138

   @jkesselm, this PR adds javadoc JAR generation to modules `xalan`, 
`serializer`, `samples`.
   
   These modules are candidates for publication on Maven Central (MC) and 
therefore need javadoc and source (J&S) JARs by default when deploying from 
Maven. The fact that previous releases did not include J&S on MC, because 
probably they were deployed manually, does not mean that we should keep it this 
way and point to the distro archives for J&S. Users should be able to fetch 
them directly from MC and use them in their IDEs seamlessly.
   
   J&S generation steps are wrapped in profiles `create-javadocs` and 
`create-sources`. It can be skipped easily by deactivating those profiles for 
quicker development builds.
   
   This brings us one step closer to using a canonical release process for the 
three main artifacts. If we also find a place to publish the Maven site, 
probably to https://xalan.apache.org/xalan-j/index.html, and make the site 
contain all relevant information to replace the current website structure for 
Xalan-J (rest of Xalan is out of scope), the need for separate source and 
binary distros goes away completely. Nobody downloads a website dump manually 
anymore, people view it online. Nobody downloads J&S manually anymore either, 
because all IDEs can do that automatically or on demand per mouse click, 
improving developer experience by showing J&S inline while using the 
corresponding library.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscr...@xalan.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@xalan.apache.org
For additional commands, e-mail: dev-h...@xalan.apache.org

Reply via email to