Kirill Gagarski
03/15/2024, 6:27 PMAdam Semenenko
03/18/2024, 1:03 PMCLOVIS
03/18/2024, 1:14 PMAdam Semenenko
03/18/2024, 1:29 PM:project-a
and :project-b
.
• The subprojects are independent, no dependencies between them
• :project-a
has a class with FQN project.a.A
• :project-b
has a class with FQN project.b.B
• If class B
has KDoc [project.a.A]
, then the link is clickable in IntelliJ, but it's not clickable in the generated Dokka docs.
Hmm, no, external links won't help with that.Adam Semenenko
03/18/2024, 4:34 PM:project-b
, Dokka will be able to inspect the classes defined in :project-a
.
In order to be defensive, I set isTransitive = false
, but that might not be necessary, or not defensive enough!Kirill Gagarski
03/19/2024, 8:06 PMdokkaSourceSetClasspath
to each other, I wonder when this approach will shoot me in the leg.
I also wonder, can (theoretically) root MultiModule task perform additional resolution of unresolved links to achieve that? Or this is totally out of the scope of this task? Given that the resulting docs are more or less monolythic artifact, this behavior kinda makes sense by default.CLOVIS
03/19/2024, 8:10 PMI wonder when this approach will shoot me in the leg.It depends how you wrote it, but at least in theory there shouldn't be any problems except that it will make the documentation generation slower.
can (theoretically) root MultiModule task perform additional resolution of unresolved links to achieve that?I'm not an expert on the internals of Dokka by far, but my understanding is the root module only combines the partial documentation from all other modules, it cannot really edit their contents to add back links that were not found earlier in the project's phase.
Kirill Gagarski
03/20/2024, 6:56 PMI'm not an expert on the internals of Dokka by far, but my understanding is the root module only combines the partial documentation from all other modules, it cannot really edit their contents to add back links that were not found earlier in the project's phase.I am no expert as well, but does not it do it for links to dependant modules? Meaning that if
module-a
depends on module-b
then links in module-a
docs to module-b
classes are resolved.CLOVIS
03/20/2024, 7:40 PMCLOVIS
03/20/2024, 7:40 PM