ci: fix docs deployment (#77)

* fix: using docs deploy defaults
* fix: temporarily changed to any branch
* fix: added upload artifact again
* fix: added missing permissions
* fix: changed upload action to upload-pages-artifact
* fix: added missing environment
* fix: added missing upload-pages-artifact version
* fix: moved deploy runs-on before steps
* fix: changed upload-pages-artifact to use v3
* fix: added checkout for gh-pages branch
* fix: reverted on push tags to v*

---------

Co-authored-by: Jordy Herrera Mussio <jordyhm@ibm.com>

.github/workflows/docs.yml

@@ -12,7 +12,7 @@ jobs:
       matrix:
         node: [ 18 ]
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Setup Node.js ${{ matrix.node }}
         uses: actions/setup-node@v2
@@ -28,25 +28,19 @@ jobs:
           npm run build
           npm run docs
 
-      - name: Upload artifact
-        id: upload-artifact
-        uses: actions/upload-artifact@v4
+      - name: Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          name: github-pages
           path: dist/docs
   Deploy:
     needs: Documentation
-
+    runs-on: ubuntu-latest
     permissions:
       pages: write
       id-token: write
-
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
-
-    runs-on: ubuntu-latest
-
     steps:
       - name: Deploy to GitHub Pages
         id: deployment