[build] fixed multi version documentation

.github/workflows/build-master.yml

@@ -1,12 +1,12 @@
-name: Build
+name: Build Master
 
 on:
   push:
     branches:
       - master
 
 permissions:
-  contents: read
+  contents: write
   pages: write
   id-token: write
 
@@ -24,19 +24,49 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+
       - uses: actions/setup-java@v3
         with:
           distribution: 'temurin'
           java-version: '17'
           cache: "gradle"
+
       - name: Build
         run: ./gradlew build
+
       - name: Build documentation
         run: ./gradlew dokkaHtml
+
       - uses: actions/configure-pages@v3
+
       - uses: actions/upload-pages-artifact@v1
         with:
           path: 'build/dokka/html'
-      - name: Deploy to GitHub Pages
+
+      - name: Deploy to Documentation GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v1
+
+      - name: Delete directory ./build/dokka/html/older
+        run: rm -Rf ./build/dokka/html/older
+
+      - name: Set VERSION from json
+        run: |
+          echo "VERSION=$(cat ./build/dokka/html/version.json | jq -r '.version')" >> "$GITHUB_ENV"
+
+      - name: Archive documentation
+        run: |
+          rm -Rf "./documentation/${{env.VERSION}}"
+          mv ./build/dokka/html "./documentation/${{env.VERSION}}"
+
+      - name: Commit documentation
+        run: |
+          # setup the username and email
+          git config user.name "GitHub Actions"
+          git config user.email "<>"
+          
+          # Stage the file, commit and push
+          git add documentation
+          git commit -m "[ci-commit] [documentation] updated documentation for ${{env.VERSION}}" || true
+          git push origin master
+

build.gradle

@@ -4,7 +4,6 @@ plugins {
     id 'org.jetbrains.kotlin.multiplatform' version "1.9.0"
     id("convention.publication")
     id "org.jetbrains.dokka" version "1.8.20"
-    id "maven-publish"
 }
 
 group 'com.fab1an'
@@ -46,6 +45,10 @@ kotlin {
     }
 }
 
+dependencies {
+    dokkaPlugin("org.jetbrains.dokka:versioning-plugin:1.8.20")
+}
+
 tasks.withType(DokkaTask.class) {
     dokkaSourceSets {
         configureEach {
@@ -54,5 +57,14 @@ tasks.withType(DokkaTask.class) {
                 packageListUrl.set(new URL("https://square.github.io/okio/3.x/okio/okio/package-list"))
             }
         }
+
+    }
+    String versioningPluginConfiguration = """
+    {
+      "olderVersionsDir": "${projectDir.toPath().resolve("documentation")}"
     }
+    """
+    pluginsMapConfiguration.set(
+            ["org.jetbrains.dokka.versioning.VersioningPlugin": versioningPluginConfiguration]
+    )
 }