Restructure the project to utilize included builds (#3174)

* Refactor and simplify artifact publishing
* Update Gradle to 8.4
* Refactor and simplify convention plugins and build scripts

Fixes #3132

---------

Co-authored-by: Adam <897017+aSemy@users.noreply.github.com>
Co-authored-by: Oleg Yukhnevich <whyoleg@gmail.com>

1 files changed, 37 insertions, 41 deletions

diff --git a/settings.gradle.kts b/settings.gradle.kts
index 359dcb97..ee2021e7 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -58,50 +58,40 @@ plugins {
     `gradle-enterprise`
 }
 
-include(
-    ":core",
-    ":core:test-api",
-    ":core:content-matcher-test-utils",
-
-    ":subprojects",
-
-    ":subprojects:analysis-java-psi",
-    ":subprojects:analysis-kotlin-api",
-    ":subprojects:analysis-kotlin-descriptors",
-    ":subprojects:analysis-kotlin-descriptors:compiler",
-    ":subprojects:analysis-kotlin-descriptors:ide",
-    ":subprojects:analysis-kotlin-symbols",
-    ":subprojects:analysis-markdown-jb",
-
-    ":runners:gradle-plugin",
-    ":runners:cli",
-    ":runners:maven-plugin",
-
-    ":plugins:base",
-    ":plugins:base:frontend",
-    ":plugins:base:base-test-utils",
-    ":plugins:all-modules-page",
-    ":plugins:templating",
-    ":plugins:versioning",
-    ":plugins:android-documentation",
-
-    ":plugins:mathjax",
-    ":plugins:gfm",
-    ":plugins:gfm:gfm-template-processing",
-    ":plugins:jekyll",
-    ":plugins:jekyll:jekyll-template-processing",
-    ":plugins:kotlin-as-java",
-    ":plugins:javadoc",
-
-    ":integration-tests",
-    ":integration-tests:gradle",
-    ":integration-tests:cli",
-    ":integration-tests:maven",
+includeBuild("dokka-integration-tests")
+includeBuild("dokka-runners/runner-gradle-plugin-classic")
+includeBuild("dokka-runners/runner-maven-plugin")
+includeBuild("dokka-runners/runner-cli")
 
+include(
     ":docs-developer",
-)
 
-includeBuild("dokka-runners/dokkatoo")
+    ":dokka-subprojects",
+    ":dokka-subprojects:analysis-java-psi",
+    ":dokka-subprojects:analysis-kotlin-api",
+    ":dokka-subprojects:analysis-kotlin-descriptors",
+    ":dokka-subprojects:analysis-kotlin-descriptors-compiler",
+    ":dokka-subprojects:analysis-kotlin-descriptors-ide",
+    ":dokka-subprojects:analysis-kotlin-symbols",
+    ":dokka-subprojects:analysis-markdown-jb",
+    ":dokka-subprojects:core",
+    ":dokka-subprojects:core-content-matcher-test-utils",
+    ":dokka-subprojects:core-test-api",
+    ":dokka-subprojects:plugin-all-modules-page",
+    ":dokka-subprojects:plugin-android-documentation",
+    ":dokka-subprojects:plugin-base",
+    ":dokka-subprojects:plugin-base-frontend",
+    ":dokka-subprojects:plugin-base-test-utils",
+    ":dokka-subprojects:plugin-gfm",
+    ":dokka-subprojects:plugin-gfm-template-processing",
+    ":dokka-subprojects:plugin-javadoc",
+    ":dokka-subprojects:plugin-jekyll",
+    ":dokka-subprojects:plugin-jekyll-template-processing",
+    ":dokka-subprojects:plugin-kotlin-as-java",
+    ":dokka-subprojects:plugin-mathjax",
+    ":dokka-subprojects:plugin-templating",
+    ":dokka-subprojects:plugin-versioning",
+)
 
 val isCiBuild = System.getenv("GITHUB_ACTIONS") != null || System.getenv("TEAMCITY_VERSION") != null
 
@@ -113,5 +103,11 @@ gradleEnterprise {
     }
 }
 
+// This hack is required for included build support.
+// The name of the published artifact is `dokka-core`, but the module is named `core`.
+// For some reason, dependency substitution doesn't work in this case. Maybe we fall under one of the unsupported
+// cases: https://docs.gradle.org/current/userguide/composite_builds.html#included_build_substitution_limitations.
+// Should no longer be a problem once Dokka's artifacts are relocated, see #3245.
+project(":dokka-subprojects:core").name = "dokka-core"
 
 enableFeaturePreview("TYPESAFE_PROJECT_ACCESSORS")