REVIEW: [NEXUS-6373] Use a capability to force base URL

https://issues.sonatype.org/browse/NEXUS-6373
update javadocs