docs: rebuild the documentation around the protocol

.github/dependabot.yml

@@ -0,0 +1,14 @@
+# Opens a pull request when a new version of the Hypercerts packages is published.
+# Merging it updates the generated lexicon schema tables and the design-system styles.
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: daily
+    allow:
+      - dependency-name: "@hypercerts-org/lexicon"
+      - dependency-name: "@hypercerts-org/ui-react"
+    commit-message:
+      prefix: chore
+    labels: []

.github/workflows/docs-ci.yml

@@ -7,20 +7,16 @@ on:
     paths:
       - '.github/workflows/docs*.yml'
       - 'docs-sources.yml'
-      - 'docs/remote-markdown.md'
       - 'components/**'
-      - 'lib/external-docs*.js'
-      - 'lib/generate-docs-fingerprint.js'
-      - 'lib/generate-external-docs-manifest.js'
-      - 'lib/generate-raw-pages.js'
-      - 'lib/generate-search-index.js'
-      - 'lib/compare-docs-fingerprint.js'
+      - 'lib/**'
+      - 'styles/**'
       - 'markdoc/**'
       - 'next.config.js'
       - 'pages/**'
       - 'test/**'
       - 'package.json'
-      - 'package-lock.json'
+      - 'pnpm-lock.yaml'
+      - 'pnpm-workspace.yaml'
 
 permissions:
   contents: read
@@ -40,19 +36,25 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v6.1.0
+
       - name: Setup Node
         uses: actions/setup-node@v6.4.0
         with:
           node-version: 22
-          cache: npm
+          cache: pnpm
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Run tests
-        run: npm test
+        run: pnpm test
 
       - name: Build static documentation
-        run: npm run build
+        run: pnpm run build
         env:
           GITHUB_TOKEN: ${{ github.token }}
+
+      - name: Check internal links
+        run: pnpm run check:links

.github/workflows/docs-refresh.yml

@@ -34,17 +34,20 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v6.1.0
+
       - name: Setup Node
         uses: actions/setup-node@v6.4.0
         with:
           node-version: 22
-          cache: npm
+          cache: pnpm
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Generate current docs fingerprint
-        run: npm run docs:fingerprint -- --output current-docs-fingerprint.json
+        run: pnpm run docs:fingerprint --output current-docs-fingerprint.json
         env:
           DOCS_SOURCE_TOKEN: ${{ secrets.DOCS_SOURCE_TOKEN }}
           GITHUB_TOKEN: ${{ github.token }}

.gitignore

@@ -13,3 +13,4 @@ current-docs-fingerprint.json
 deployed-docs-fingerprint.json
 lib/external-docs-content.json
 lib/lastUpdated.json
+lib/release-catalog.json