Merge pull request #642 from kaggis/update-docs

ARGO-5106 Migrate mkdocs to latest docusaurus

Author: themiszamani

.github/workflows/docs.yml

@@ -0,0 +1,59 @@
+# .github/workflows/docs.yml
+name: Deploy documentation to github pages
+
+# Define when to run action
+on:
+  # run action on push to devel branch
+  push:
+    branches: [ devel ]
+  
+  # run also this workflow manually when needed
+  workflow_dispatch:
+
+# github token permissions are set here
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# deployment concurrency set to one
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+defaults:
+  run:
+    working-directory: website
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout docusaurus repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node environment
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22' 
+          cache: 'npm'
+          cache-dependency-path: docs/package-lock.json
+
+      - name: Install deps
+        run: npm i
+
+      - name: Build docs
+        run: npm run build
+
+      - name: Run gh action to setup pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload docs
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'docs/build'
+
+      - name: Run gh action to deploy to github pages
+        id: deployment
+        uses: actions/deploy-pages@v4

doc/v1/docs/index.md

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

doc/v1/docs/superadmin_administration.md

@@ -0,0 +1,6 @@
+{
+  "label": "SuperAdmin Poem",
+  "position": 1,
+  "collapsed": false,
+  "link": { "type": "generated-index", "description": "Start here" }
+}

doc/v1/mkdocs.yml

@@ -0,0 +1,6 @@
+{
+  "label": "Administration",
+  "position": 1,
+  "collapsed": false,
+  "link": { "type": "generated-index", "description": "Start here" }
+}