Add module documentation and enhance Dokka configuration

- Add workflow to build and publish API documentation with Dokka
  - Introduce `.github/workflows/apidocs.yaml` to build and deploy API docs on `main` and release events.
  - Configure Gradle for Dokka builds and update project dependencies.
  - Include `:docs` module in project settings.
- Introduce `Module.md` for `kotlin-sdk-server`, `kotlin-sdk-client`, and `kotlin-sdk-core` modules.
- Update `.gitignore` to include `.idea/icon.png` and add placeholder icon files
- Remove outdated documentation HTML files

Author: kpavlov

.github/workflows/apidocs.yaml

@@ -0,0 +1,51 @@
+name: Build and Publish API Docs to GitHub Pages
+
+on:
+  release:
+    types:
+      - published
+  push:
+    branches: [ "main" ]
+  # Allow running this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  deploy:
+
+    permissions:
+      pages: write      # to deploy to Pages
+      id-token: write   # to verify the deployment originates from an appropriate source
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          submodules: true  # Fetch Hugo themes (true OR recursive)
+          fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v5
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: gradle
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@ed408507eac070d1f99cc633dbcf757c94c7933a # v4.4.3
+
+      - name: Generate Dokka Site
+        run: |-
+          ./gradlew :docs:clean :docs:dokkaGenerate
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: docs/build/dokka/html
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -11,6 +11,7 @@ build/
 .idea/compiler.xml
 .idea/libraries/
 .idea
+!.idea/icon.png
 *.iws
 *.iml
 *.ipr

.idea/icon.png

@@ -5,19 +5,55 @@ plugins {
 }
 
 dokka {
-    moduleName.set("MCP Kotlin SDK - ${project.name}")
 
     dokkaSourceSets.configureEach {
+        includes.from("Module.md")
+
+        pluginsConfiguration.html {
+            footerMessage = "Copyright © 2025 JetBrains s.r.o."
+            customAssets + file("icon.png")
+        }
+
         sourceLink {
             localDirectory = projectDir.resolve("src")
             remoteUrl("https://github.com/modelcontextprotocol/kotlin-sdk/tree/main/${project.name}/src")
             remoteLineSuffix = "#L"
         }
 
         documentedVisibilities(VisibilityModifier.Public)
-    }
 
-    dokkaPublications.html {
-        outputDirectory = rootProject.layout.projectDirectory.dir("docs/${project.name}")
+        externalDocumentationLinks.register("ktor-client") {
+            url("https://api.ktor.io/ktor-client/")
+            packageListUrl("https://api.ktor.io/package-list")
+        }
+
+        externalDocumentationLinks.register("kotlinx-coroutines") {
+            url("https://kotlinlang.org/api/kotlinx.coroutines/")
+            packageListUrl("https://kotlinlang.org/api/kotlinx.coroutines/package-list")
+        }
+
+        externalDocumentationLinks.register("kotlinx-serialization") {
+            url("https://kotlinlang.org/api/kotlinx.serialization/")
+            packageListUrl("https://kotlinlang.org/api/kotlinx.serialization/package-list")
+        }
     }
-}
+}
+//
+// tasks.withType<DokkaTask>().configureEach {
+//    val dokkaBaseConfiguration = """
+//    {
+//      "customAssets": ["${file("assets/my-image.png")}"],
+//      "customStyleSheets": ["${file("assets/my-styles.css")}"],
+//      "footerMessage": "(c) $Insta MyOrg",
+//      "separateInheritedMembers": false,
+//      "templatesDir": "${file("dokka/templates")}",
+//      "mergeImplicitExpectActualDeclarations": false
+//    }
+//    """
+//    pluginsMapConfiguration.set(
+//        mapOf(
+//            // fully qualified plugin name to json configuration
+//            "org.jetbrains.dokka.base.DokkaBase" to dokkaBaseConfiguration,
+//        ),
+//    )
+// }