Hi, I'm using Dokka to generate documentation for ...
# dokka
d
Hi, I'm using Dokka to generate documentation for a multi-language project. I have successfully generated documentation in both Kotlin and Java formats (using the kotlin-as-java plugin) in separate tasks and reports. My question is, does Dokka support generating a combined documentation set where docs for Java code are displayed in Java format and docs for Kotlin code are displayed in Kotlin format on the same site? If this isn't currently supported, is this feature planned for future implementation? Thank you in advance.
o
Hey! just to clarify: you do generate Dokka's HTML with
kotlin-as-java
plugin and not Dokka's Javadoc?
does Dokka support generating a combined documentation set where docs for Java code are displayed in Java format and docs for Kotlin code are displayed in Kotlin format on the same site?
nope, but could you describe use-case a bit, on why do you want that?
If this isn't currently supported, is this feature planned for future implementation?
There are no plans to implement something like this currently
d
Hello! Yes, I'm using the
kotlin-as-java
plugin to generate Dokka's HTML, and I like how it handles Java-style formatting for Java code. However, I would prefer the API documentation for Kotlin code to remain in Kotlin format, as the Java-style format can sometimes feel out of place for Kotlin. Thank you for your response.
o
Okay, I see what you want. One additional question: why having java-style formatting is seems useful to you? I mean, Dokka generates API reference mostly for Kotlin users, and so for them, calling java code will look more similar to how Dokka shows it I'm just trying to better understand, why do you want to see
java signatures
in Kotlin API reference? May be I'm missing something Anyway, thanks!