chore: deploy dokka website action

Author: sureshg

.github/workflows/build.yml

@@ -55,8 +55,10 @@ jobs:
             cmd: ./gradlew.bat
 
     steps:
-      - name: Check out the source code
+      - name: 🛎️ Check out the source code
         uses: actions/checkout@v2
+        with:
+          fetch-depth: 100
 
       - name: Download ${{ matrix.os }} OpenJDK ${{ matrix.jdk }}
         id: download-jdk
@@ -94,7 +96,7 @@ jobs:
           echo "::set-output name=name::$NAME"
           echo "::set-output name=artifact::$ARTIFACT"
 
-      - name: Publish to GitHub Packages (Linux)
+      - name: 📦 Publish to GitHub Packages (Linux)
         id: gradle-publish
         if: env.GITHUB_PUBLISH == 'true' && runner.os == 'Linux'
         run: |
@@ -103,9 +105,9 @@ jobs:
           GITHUB_USER: ${{ github.repository_owner }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Gradle Run & Build
+      - name: 🔧 Gradle Run & Build
         id: gradle-build
-        run: ./gradlew run build
+        run: ./gradlew run build dokkaHtml
 
       - name: Uploading ${{ matrix.os }} uber jar
         if: steps.gradle-build.outcome == 'success' && runner.os == 'Linux'
@@ -116,6 +118,16 @@ jobs:
             ${{ steps.gradle-build.outputs.uberjar_path }}
           if-no-files-found: error
 
+      - name: 🚀 Deploy html docs to website
+        if: runner.os == 'Linux'
+        uses: JamesIves/github-pages-deploy-action@releases/v3
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: main
+          FOLDER: build/dokka
+          TARGET_FOLDER: docs/apidoc/
+          CLEAN: true
+
   release:
     name: Release new version.
     needs: [ build ]
@@ -155,18 +167,21 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
   container-build:
-    name: Run Java on Container
+    name: 🚢 Run Java on Container
     runs-on: ubuntu-latest
 
     strategy:
       fail-fast: true
       matrix:
-        jdk: [ "17-slim-buster", "17-alpine" ]
+        jdk: [ "openjdk:17-slim-buster", "openjdk:17-alpine" ]
 
+    defaults:
+      run:
+        shell: sh
 
     container:
       # openjdk:17-jdk-alpine
-      image: openjdk:${{ matrix.jdk }}
+      image: ${{ matrix.jdk }}
 
     steps:
       - name: Check out the source code
@@ -178,7 +193,6 @@ jobs:
           java --show-version src/main/java/JavaApp.java
         env:
           RUNNER_CONTEXT: ${{ toJson(runner) }}
-        shell: sh
 
       - name: Github Action Contexts
         run: |
@@ -189,4 +203,3 @@ jobs:
           JOB_CONTEXT: ${{ toJson(job) }}
           STEPS_CONTEXT: ${{ toJson(steps) }}
           RUNNER_CONTEXT: ${{ toJson(runner) }}
-        shell: sh

build.gradle.kts

@@ -1,11 +1,11 @@
 import gg.jte.*
+import java.net.*
+import java.nio.file.Path
 import org.gradle.api.tasks.testing.logging.*
 import org.gradle.internal.os.OperatingSystem
 import org.jetbrains.dokka.gradle.*
 import org.jetbrains.kotlin.config.*
 import org.jetbrains.kotlin.gradle.tasks.*
-import java.net.*
-import java.nio.file.Path
 
 plugins {
   idea
@@ -178,7 +178,7 @@ spotless {
     endWithNewline()
     indentWithSpaces()
     trimTrailingWhitespace()
-    // licenseHeader(License.Apache)
+    //licenseHeader(rootProject.file("gradle/license-header.txt"))
   }
 
   kotlinGradle {

docs/JDK Commands.md

@@ -129,10 +129,9 @@ $ java  --enable-preview \
 ```
 
 * [JPMS Quickstart](https://openjdk.java.net/projects/jigsaw/quick-start)
-
 * [Docs and Resources](https://openjdk.java.net/projects/jigsaw/)
-
 * **[Java Modules Cheat Sheet](https://nipafx.dev/build-modules/)**
+* [JPackage Scripts](https://github.com/dlemmermann/JPackageScriptFX)
 
 ##### 9. [JVMCI (Graal) Compiler](https://openjdk.java.net/jeps/317)
 
@@ -302,13 +301,13 @@ println("Hello Kotlin Script")
      ```bash
      # Turn on all debugging
      $ java -Djavax.net.debug=all
-
+     
      # Override HostsFileNameService
      $ java -Djdk.net.hosts.file=/etc/host/style/file
-
+     
      # Force IPv4
      $ java -Djava.net.preferIPv4Stack=true
-
+     
      # The entropy gathering device can also be specified with the system property
      $ java -Djava.security.egd=file:/dev/./urandom
      ```
@@ -473,7 +472,7 @@ sourceSets.main.get().compileClasspath
   val u: TaskProvider<Jar> = register<Jar>("jar"){}     // Create new task
   val v: TaskProvider<Jar> by registering(Jar::class){} // Create task using property delegate
   val jar: TaskProvider<Task> by existing // Get task using property delegate
-
+  
   val foo: FooTask by existing            // Take Task type from val (Kotlin 1.4)
   val bar: BarTask by registering {}      // Take Task type from val (Kotlin 1.4)
   ```