I have put a new release candidate for SDO Java up at http://people.apache.org/~kelvingoodson/sdo_java/RC3/
This tries to take into account the comments that the sample distribution does not need to be stand alone, and that javadoc should be shipped with the binary and sample distributions. I have been fighting with the maven build environment to produce a good set of javadoc as part of the build, from a user's perspective, but that's not at all easy given the structure of our projects and the nature of the maven javadoc plugin, so currently the binary distribution carries javadoc for the sdo api and all of the tuscany implementation. The README file draws the attention of an SDO user to relevant classes in the tuscany implementation javadoc. Regards, Kelvin.