A modern programming language that makes developers happier.

kotlinlang

*_Question About_: Linking documentation from <http://javadoc.io|javadoc.io>*

Hi! I'm configuring dokka for my team's Kotlin project, and I want to link the OpenTelemetry's documentation. For example, for the package `io.opentelemetry:opentelemetry-api`, the documentation is hosted <https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/|here>; however, for <https://javadoc.io>, I cannot find a link that would download the `package-list` (I have several OpenTelemetry modules hosted on <http://javadoc.io|javadoc.io>).

On the official dokka documentation, I only found examples for <http://kotlinlang.org|kotlinlang.org> and <http://docs.oracle.com|docs.oracle.com> hosts.

*Please suggest to me the way to link documentation from <http://javadoc.io|javadoc.io>.*

I tried the following:
```dokka {
  dokkaSourceSets.configureEach { 
        externalDocumentationLinks.register("opentelemetry-api") {
            url("<https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/>")
            packageListUrl("<https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/package-list>")
        }
  }
}```
But it fails with:
```Failed to download package-list from <https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/package-list>, this might suggest that remote resource is not available, module is empty or dokka output got corrupted```


It looks like <http://javadoc.io|javadoc.io> doesn't support downloading the 'latest' version of the `element-list` file (`package-list` was renamed to `element-list` in Java 10, so OTel must've been built with a newer JDK).


• <https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/1.55.0/element-list> works
• <https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/element-list> doesn't work


That's probably worth reporting it to the <http://javadoc.io|javadoc.io> maintainer, he's not very quick to answer but he did fix things the last time I had a dokka-related issue on his site

image.png

&gt; It looks like <http://javadoc.io|javadoc.io> doesn't support downloading the 'latest' version of the `element-list` file
works at my side (screen proof), but it should be `element-list` specifically, `package-list` is just an empty file
And Dokka also <https://github.com/Kotlin/dokka/blob/d4d457d357627fd8100e4f0d47868020485996ec/dokka-subprojects/plugin-base/src/main/kotlin/org/jetbrains/dokka/base/resolvers/shared/utils.kt#L25|follows redirects>

Could you recheck with the link changed to point to `element-list`?
```dokka {
  dokkaSourceSets.configureEach { 
        externalDocumentationLinks.register("opentelemetry-api") {
            url("<https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/>")
            packageListUrl("<https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/element-list>")
        }
  }
}```
(and as a bonus, <https://github.com/Kotlin/dokka/issues/2097|the Dokka issue> about `element-list` support out-of-the-box without custom `packageListUrl`)

oh, `latest/element-list` works for me now too