Split module and package documentation

Author: bastianeicher

build.gradle.kts

@@ -28,12 +28,12 @@ subprojects {
     dokka {
         dokkaSourceSets.configureEach {
             // Package-level documentation
-            val mdFiles = fileTree("src/main/kotlin") {
+            val mdFiles = fileTree("src/main") {
                 include("**/_doc.md")
             }
             mdFiles.files.forEach { mdFile ->
                 // Avoid duplicate file name conflicts
-                val relativePath = mdFile.relativeTo(project.file("src/main/kotlin")).path.replace("/", "-").replace("\\", "-")
+                val relativePath = mdFile.relativeTo(project.file("src/main")).path.replace("/", "-").replace("\\", "-")
                 val uniqueFile = project.layout.buildDirectory.file("tmp/dokka-includes/$relativePath").get().asFile
                 uniqueFile.parentFile.mkdirs()
                 mdFile.copyTo(uniqueFile, overwrite = true)

typedrest-serializers-jackson/src/main/_doc.md

@@ -0,0 +1,5 @@
+# Module typedrest-serializers-jackson
+
+Adds support for serializing using [Jackson](https://github.com/FasterXML/jackson) instead of [kotlinx.serialization](https://kotlinlang.org/docs/serialization.html).
+
+Pass [JacksonJsonSerializer](net.typedrest.serializers.JacksonJsonSerializer) to the [EntryEndpoint](net.typedrest.endpoints.EntryEndpoint) constructor.

typedrest-serializers-jackson/src/main/kotlin/net/typedrest/serializers/_doc.md

@@ -1,5 +1,3 @@
-# Module typedrest-serializers-jackson
+# Package net.typedrest.serializers
 
-Adds support for serializing using [Jackson](https://github.com/FasterXML/jackson) instead of [kotlinx.serialization](https://kotlinlang.org/docs/serialization.html).
-
-Pass [JacksonJsonSerializer](net.typedrest.serializers.JacksonJsonSerializer) to the [EntryEndpoint](net.typedrest.endpoints.EntryEndpoint) constructor.
+Serialization of entities sent to and received from the server.

typedrest-serializers-moshi/src/main/_doc.md

@@ -0,0 +1,5 @@
+# Module typedrest-serializers-moshi
+
+Adds support for serializing using [Moshi](https://github.com/square/moshi) instead of [kotlinx.serialization](https://kotlinlang.org/docs/serialization.html).
+
+Pass [MoshiJsonSerializer](net.typedrest.serializers.MoshiJsonSerializer) to the [EntryEndpoint](net.typedrest.endpoints.EntryEndpoint) constructor.

typedrest-serializers-moshi/src/main/kotlin/net/typedrest/serializers/_doc.md

@@ -1,5 +1,3 @@
-# Module typedrest-serializers-moshi
+# Package net.typedrest.serializers
 
-Adds support for serializing using [Moshi](https://github.com/square/moshi) instead of [kotlinx.serialization](https://kotlinlang.org/docs/serialization.html).
-
-Pass [MoshiJsonSerializer](net.typedrest.serializers.MoshiJsonSerializer) to the [EntryEndpoint](net.typedrest.endpoints.EntryEndpoint) constructor.
+Serialization of entities sent to and received from the server.

typedrest/src/main/_doc.md

@@ -0,0 +1,3 @@
+# Module typedrest
+
+The main TypedRest library.

typedrest/src/main/kotlin/net/typedrest/_doc.md

@@ -1,7 +1,3 @@
-# Module typedrest
-
-The main TypedRest library.
-
 # Package net.typedrest
 
 Common helpers and extensions.