From ecbc34ceb41c35d2ab41eb965d5f3bcf6840061d Mon Sep 17 00:00:00 2001
From: Erik Golinelli <erik@codekraft.it>
Date: Sat, 2 Dec 2023 21:49:48 +0100
Subject: [PATCH] Update GitHub deployment method in jsDoc workflow

This commit restructures the .github/workflows/jsDoc.yml file to use GITHUB_TOKEN for deployment to Github Pages, rather than the previous deploy_key. This change boosts security and simplifies the workflow by leveraging built-in features of GitHub.
---
 .github/workflows/jsDoc.yml | 32 ++++++++++++++------------------
 1 file changed, 14 insertions(+), 18 deletions(-)

diff --git a/.github/workflows/jsDoc.yml b/.github/workflows/jsDoc.yml
index 215f5d2..c9186d0 100644
--- a/.github/workflows/jsDoc.yml
+++ b/.github/workflows/jsDoc.yml
@@ -8,25 +8,19 @@ on:
     types: [ closed ]
     branches:
       - master
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
 
-jobs:
-  build:
-    name: Build
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v3
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
 
+jobs:
   # Single deploy job since we're just deploying
   deploy:
-    name: Deploy
-    needs: build
-
-    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
+    name: Deploy Documentation
 
     # Deploy to the github-pages environment
     environment:
@@ -37,24 +31,26 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v3
 
-      - name: Build
+      - name: Build Docs
         uses: andstor/jsdoc-action@v1
         with:
           source_dir: ./lib
           recurse: true
-          output_dir: ./out
+          output_dir: ./
           config_file: jsdoc.json
           front_page: readme.md
 
       - name: Setup Pages
         uses: actions/configure-pages@v3
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v2
         with:
           # Upload entire repository
           path: '.'
+
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v2