DGPv2: missing `dokkaGenerateHtml` and `dokkaGenerateJavadoc` lifecycle tasks

[adam-enko]

The DGPv2 migration docs reference tasks that don't exist

https://github.com/Kotlin/dokka/blob/fc574c855fb75a4fe30185aa9f12b74295b095d4/docs/topics/dokka-migration.md?plain=1#L405

The tasks should exist, and the tasks names are defined here, but for some unknown reason they are not registered as tasks (mistake while copying Dokkatoo? Or during another PR? Or were they intentionally removed?).

Tasks

• [ ] Find out what tasks should be used instead of dokkaGenerateHtml and dokkaGenerateJavadoc. (Probably dokkaGeneratePublicationHtml?)
• [ ] The docs should be updated to remove the references. Instead replace them with the above.
• [ ] Investigate and determine if the tasks should be re-added. (I'm on the fence. I think it's confusing if there's too many tasks, but on the other hand dokkaGeneratePublicationHtml is a mouthful, and there's no obvious difference between it and dokkaGenerateModuleHtml, so a shorter lifecycle helper task could help.)

[StefMa]

Hi @adam-enko,

I also just ran into this problem. I agree that it is super confusing for developers to have dokkaGeneratePublicationHtml and dokkaGenerateModuleHtml but no dokkaGenerateHtml. Actually you don't know the difference btween publication and module 👀

I just jumped within the code and observerd the following:

• The DokkaBasePlugin will generate the dokkaGenerate task
• The DokkaHtmlPlugin (not sure where this gets instantiated) has html as format name
• The DokkaHtmlPlugin is a instance of DokkaFormatPlugin
• The DokkaFormatPlugin (that has now html as format) create a publication with html and use publication.formatName as argument for the DokkaFormatTasks
• The publication.formatName is identical to the original format name (so still html)
• The DokkaFormatTasks however, only provides dokkaGeneratePublication(FormatName) and dokkaGenerateModule(FormatName) tasks. There is no sign of a generic dokkaGenerate(FormatName) task instantiation. Without having much knowledge about the code base, I think it should be here 👀 that is the reason why I mention it 🙃

I'm not sure if any of this helps 🙈 But just wanted to drop it here.

In case someone is searching why I faced this issue: I had this before:

val dokkaJar = tasks.register<Jar>("dokkaJar") {
    dependsOn(tasks.dokkaHtml)
    from(tasks.dokkaHtml.flatMap { it.outputDirectory })
    archiveClassifier.set("javadoc")
}

And searched how to replace that. This is the "new solution":

// New
val dokkaJar = tasks.register<Jar>("dokkaJar") {
    dependsOn(tasks.dokkaGenerate)
    from(tasks.dokkaGeneratePublicationHtml.flatMap { it.outputDirectory })
    archiveClassifier.set("javadoc")
}