When using Javadoc, links to classes and interfaces within the same project (same source code base) usually show up as hyperlinks. For instance, from the Ant-built Tapestry docs: http://jakarta.apache.org/tapestry/doc/api/org/apache/tapestry/IEngine.html#getDataSqueezer() The return value, DataSqueezer, is is a link to http://jakarta.apache.org/tapestry/doc/api/org/apache/tapestry/util/io/DataSqueezer.html However, in my Maven built-documentation, it's not the same: http://jakarta.apache.org/commons/sandbox/hivemind/commons-hivemind/apidocs/org/apache/commons/hivemind/Registry.html#getModule(java.lang.String) Here, the Module interface (from within the very same Java package) shows up as a non-link, with its full class name spelled out. Links I create using the {@link ...} directives work fine.