Links to Framework and Servlet Javadoc from Framework's Kotlin API documentation are broken

[wilkinsona]

Affects: 6.0.x and 6.1.x

When the Kotlin API documentation links to types and methods in the Java API, those links are broken.

For example, https://docs.spring.io/spring-framework/docs/6.0.x/kdoc-api/spring-beans/org.springframework.beans.factory/index.html links to https://docs.spring.io/spring-framework/docs/6.0.x/kdoc-api/spring-beans/org.springframework.beans.factory/-listable-bean-factory/index.html which 404s.

5.3.x is not affected where, for example, https://docs.spring.io/spring-framework/docs/5.3.x/kdoc-api/spring-beans/org.springframework.beans.factory/index.html links to https://docs.spring.io/spring-framework/docs/5.3.x/javadoc-api/org/springframework/beans/factory/ListableBeanFactory.html.

We had the same problem in Spring Boot's Kotlin API documentation and fixed it by configuring the package list URL to point to the element list for the Java API. We're using Dokkatoo, but perhaps a similar fix is possible with the Dokka Gradle plugin.

[sbrannen]

Indeed, when running the :spring-beans:dokkaHtmlPartial Gradle task on 6.1.x, we see the following error.

Failed to download package-list from https://docs.spring.io/spring-framework/docs/current/javadoc-api/package-list, this might suggest that remote resource is not available, module is empty or dokka output got corrupted

Thanks for reporting this!

I'm looking into it.

---

We see the same kind of error for the Servlet API.

Failed to download package-list from https://javadoc.io/doc/jakarta.servlet/jakarta.servlet-api/latest/package-list, this might suggest that remote resource is not available, module is empty or dokka output got corrupted

[aSemy]

Looks like the link has changed:

• https://docs.spring.io/spring-framework/docs/current/javadoc-api/package-list ❌
• https://docs.spring.io/spring-framework/docs/current/javadoc-api/element-list ✅

IIRC the default name changed in a newer Java version.

I just wanted to highlight this because it's a common problem. Maybe there's a way it can be made better on the Dokka side?