Skip to content

Graph-Native Infrastructure for Context and Accountable AI Systems

ci(docs): restore GitHub Pages deployment using mint export instead of mkdocs

KaifAhmad1cf802cffe922
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 7e1b4394..29435038 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -17,6 +17,8 @@ on:
permissions:
contents: read
+ pages: write
+ id-token: write
concurrency:
group: "pages"
@@ -24,7 +26,7 @@ concurrency:
jobs:
build:
- name: Validate Documentation
+ name: Build Documentation
runs-on: ubuntu-latest
steps:
- name: Checkout code
@@ -35,5 +37,43 @@ jobs:
with:
python-version: '3.11'
- - name: Validate documentation
+ - name: Set up Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: '20'
+
+ - name: Validate docs structure
run: python docs_check.py
+
+ - name: Validate Mintlify build
+ run: cd docs && npx mintlify validate
+
+ - name: Export static site
+ run: |
+ cd docs
+ npx mintlify export --output ../export.zip
+ cd ..
+ unzip -q export.zip -d site
+
+ - name: Setup Pages
+ if: github.event_name != 'pull_request'
+ uses: actions/configure-pages@v6
+
+ - name: Upload artifact
+ if: github.event_name != 'pull_request'
+ uses: actions/upload-pages-artifact@v5
+ with:
+ path: ./site
+
+ deploy:
+ name: Deploy to GitHub Pages
+ if: github.event_name != 'pull_request'
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@v5