Add debug utility for manually overriding the Dokka configuration JSON

[adam-enko]

Being able to make minor manual modifications to the Dokka configuration is exceptionally useful for local debugging.

This should not be used in production, and it is protected by an opt-in API.

[whyoleg]

I'm not against to having this, though I don't fully understand, how it could help during local debugging. Could you explain it a bit?

[adam-enko]

I'm not against to having this, though I don't fully understand, how it could help during local debugging. Could you explain it a bit?

For example, @antohaby and I looked at improving KMP handling. It was convenient to be able to manually modify the Dokka configuration rather than trying to modify the Gradle config that DGP uses to produce the Dokka config.

For example, we could manually add/remove files from the dependencies that Dokka Generator analyses, or change the order of the files. Changing the order of the files would be quite difficult to do by modifying the Gradle build config.

So, instead we added this util. So we could run :dokkaGenerate, take the dokka-config.json, and quickly modify it to experiment with different configuration. Once we found some configuration that worked, we could focus on making DGP produce the correct config.

[antohaby]

what's manualJsonConfig ? I don't see it anywhere. Perhaps you meant overrideJsonConfig :)

[adam-enko]

Thanks! Fixed.

[antohaby]

I'm afraid it can be abused in the future. But on the other hand why not? someone can also apply patches to the json files when necessary.