DGP v2 migration guide

[AlejandraPedroza]

This PR contains a guide to migrate to Dokka Gradle Plugin v2

KT-70619/

[whyoleg]

Nice!
But looks like I still have some small remarks :)

[adam-enko]

Great work!

I agree with the remaining comments, so they should be resolved.

I'm keen to get this merged ASAP, so we can keep refining it (which will be easier when I can more easily see the rendered output!), and get early feedback.

[atyrin]

I think we missing a migration tip for a popular custom option from Dokka settings:

tasks.dokkaHtml{
    dokkaSourceSets {
        configureEach {
            outputDirectory.set(layout.buildDirectory.dir("dokkaDir"))
        }
    }
}

As I understand, the new version is:

dokka {
    dokkaPublicationDirectory.set(layout.buildDirectory.dir("dokkaDir"))
}

[whyoleg]

Nice! Thank you for resolving all of the comments!

[zamulla]

Huge work! Most of my suggestions are surface-level, but I did offer some thoughts on clearer communication here and there.

[zamulla]

One more comment for clarification, otherwise, no notes 💪