add workflow to build and push docs

Author: Taz03

.github/workflows/docs.yaml

@@ -0,0 +1,33 @@
+name: Build docs and push to gh-pages branch
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    name: Compile and Push
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: '17'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v5
+
+      - name: Build documentation
+        run: ./gradlew dokkaHtml --no-configuration-cache
+
+      - name: Push to GH Pages branch
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs