On 12/09/2017 12:11 AM, Robert Varga wrote: > Hello Thanh, everyone, > > regarding javadocs, I have a couple of questions: > > It seems the latest javadoc for yangtools is 2.0.0-SNAPSHOT -- is this > something we need to rectify in release jobs?
Thanh will have to answer this. I don't know how the docs are getting generated. > Would it be possible to setup opendaylight.org to support > https://maven.apache.org/plugins-archives/maven-javadoc-plugin-2.10.3/javadoc-mojo.html#detectLinks > ? > > I am thinking something like configuring yangtools' url to be > https://yangtools.opendaylight.org/${project.version}/ -- which would > mean that yangtools.opendaylight.org/2.0.0/apidocs would need to > redirect to javadocs.opendaylight.org. This obviously requires > understanding how opendaylight.org is structured -- do we have some > document detailing how our web namespace is carved up? > > This would allow us to build properly cross-referenced javadocs across > our projects... The bailing wire and bubble gum that is making javadocs.opendaylight.org function properly does not make it possible to have a domain name per project. Plus it would be an extra amount of administrative overhead on us to do this as it would require extra configuration of puppet configuration for each project if I could figure out the extra magic needed. Each of the projects can be referenced at https://javadocs.opendaylight.org/${project_short_code} which maps to the actual official URL of https://javadocs.opendaylight/${group_id}.${project} -Andy- -- Andrew J Grimberg Lead, IT Release Engineering The Linux Foundation
signature.asc
Description: OpenPGP digital signature
_______________________________________________ infrastructure mailing list [email protected] https://lists.opendaylight.org/mailman/listinfo/infrastructure
