Merge branch 'production' into ranbel/warp-mtu

merge in docs site functionality

.github/CODEOWNERS

@@ -18,13 +18,13 @@
 
 # AI
 
-/src/content/docs/ai-gateway/ @kathayl @G4brym @mchenco @pdwittig @daisyfaithauma @cloudflare/pcx-technical-writing
-/src/content/docs/workers-ai/ @rita3ko @pdwittig @craigsdennis @markdembo @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
+/src/content/docs/ai-gateway/ @kathayl @G4brym @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
+/src/content/docs/workers-ai/ @rita3ko @craigsdennis @markdembo @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
 /src/content/docs/workers-ai/static @mchenco @craigsdennis @cloudflare/pcx-technical-writing
-/src/content/docs/vectorize/ @elithrar @vy-ton @pdwittig @sejoker @cloudflare/pcx-technical-writing
-/src/content/changelogs/workers-ai.yaml @kathayl @G4brym @mchenco @pdwittig @daisyfaithauma @cloudflare/pcx-technical-writing
-/src/content/changelogs/ai-gateway.yaml @kathayl @G4brym @mchenco @pdwittig @daisyfaithauma @cloudflare/pcx-technical-writing
-/src/content/changelogs/vectorize.yaml @elithrar @pdwittig @sejoker @cloudflare/pcx-technical-writing
+/src/content/docs/vectorize/ @elithrar @vy-ton @sejoker @cloudflare/pcx-technical-writing
+/src/content/changelogs/workers-ai.yaml @kathayl @G4brym @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
+/src/content/changelogs/ai-gateway.yaml @kathayl @G4brym @mchenco @daisyfaithauma @cloudflare/pcx-technical-writing
+/src/content/changelogs/vectorize.yaml @elithrar @sejoker @cloudflare/pcx-technical-writing
 
 # Analytics & Logs
 

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    versioning-strategy: "increase"
+    commit-message:
+      prefix: "[Docs Site] "
+    schedule:
+      interval: "daily"
+    assignees:
+      - "KianNH"
+    reviewers:
+      - "KianNH"

.github/workflows/anchor-link-audit.yml

@@ -36,7 +36,7 @@ jobs:
 
       - run: npm ci
 
-      - run: npx astro build
+      - run: npm run build
         env:
           NODE_OPTIONS: "--max-old-space-size=4192"
 

.github/workflows/ci.yml

@@ -20,19 +20,12 @@ jobs:
       - uses: actions/setup-node@v4
         with:
           node-version: 22
-
-      - name: Get npm cache directory
-        id: npm-cache-dir
-        shell: bash
-        run: echo "dir=$(npm config get cache)" >> ${GITHUB_OUTPUT}
-
-      - uses: actions/cache@v4
-        id: npm-cache
+          cache: "npm"
+      - uses: actions/cache/restore@v4
         with:
-          path: ${{ steps.npm-cache-dir.outputs.dir }}
-          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
-          restore-keys: |
-            ${{ runner.os }}-node-
+          path: |
+            node_modules/.astro
+          key: static
 
       - run: npm ci
       - run: npm run check
@@ -44,5 +37,14 @@ jobs:
           NODE_OPTIONS: "--max-old-space-size=4192"
           RUN_LINK_CHECK: true
 
+      - uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules/.astro
+          key: static
+
       - name: Check - Validate redirects (infinite loops, sources with fragment)
         run: npx tsm bin/validate-redirects.ts
+
+      - name: Tests
+        run: npm run test

.github/workflows/publish-preview.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-22.04
     permissions:
       contents: read
-    name: Publish to Cloudflare Pages (Preview)
+    name: Publish Preview
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -23,25 +23,24 @@ jobs:
       - uses: actions/cache/restore@v4
         with:
           path: |
-            node_modules/.astro/_astro
-            node_modules/.astro/assets
+            node_modules/.astro
           key: static
-      - run: npx astro build
+      - run: npm run build
+        name: Build
         env:
           NODE_OPTIONS: --max-old-space-size=4096
       - run: npx wrangler pages deploy --project-name cloudflare-docs dist
         name: Deploy to Cloudflare Pages
         env:
           CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
-      - run: npm run build:worker && npx wrangler versions upload -c ./wrangler-workers.toml
-        name: Deploy to Cloudflare Workers [preview]
+      - run: npx wrangler versions upload -c ./wrangler-workers.toml
+        name: Deploy to Cloudflare Workers
         env:
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
       - uses: actions/cache/save@v4
         if: always()
         with:
           path: |
-            node_modules/.astro/_astro
-            node_modules/.astro/assets
+            node_modules/.astro
           key: static

.github/workflows/publish-production.yml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ubuntu-22.04
     permissions:
       contents: read
-    name: Publish to Cloudflare Pages (Production)
+    name: Publish Production
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -19,21 +19,24 @@ jobs:
       - uses: actions/cache/restore@v4
         with:
           path: |
-            node_modules/.astro/_astro
-            node_modules/.astro/assets
+            node_modules/.astro
           key: static
-      - run: npx astro build
+      - run: npm run build
+        name: Build
         env:
           NODE_OPTIONS: --max-old-space-size=4096
       - run: npx wrangler pages deploy --project-name cloudflare-docs dist
         name: Deploy to Cloudflare Pages
         env:
           CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      - run: npx wrangler deploy -c ./wrangler-workers.toml
+        name: Deploy to Cloudflare Workers
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
       - uses: actions/cache/save@v4
         if: always()
         with:
           path: |
-            node_modules/.astro/_astro
-            node_modules/.astro/assets
+            node_modules/.astro
           key: static

astro.config.ts

@@ -4,7 +4,6 @@ import tailwind from "@astrojs/tailwind";
 import starlightDocSearch from "@astrojs/starlight-docsearch";
 import starlightImageZoom from "starlight-image-zoom";
 import liveCode from "astro-live-code";
-import rehypeSlug from "rehype-slug";
 import rehypeMermaid from "rehype-mermaid";
 import rehypeAutolinkHeadings, {
 	type Options as rehypeAutolinkHeadingsOptions,
@@ -17,6 +16,7 @@ import icon from "astro-icon";
 import sitemap from "@astrojs/sitemap";
 import react from "@astrojs/react";
 import rehypeTitleFigure from "rehype-title-figure";
+import rehypeHeadingSlugs from "./plugins/rehype/heading-slugs";
 
 const runLinkCheck = process.env.RUN_LINK_CHECK || false;
 
@@ -95,7 +95,7 @@ export default defineConfig({
 					rel: ["noopener"],
 				},
 			],
-			rehypeSlug,
+			rehypeHeadingSlugs,
 			[rehypeAutolinkHeadings, autolinkConfig],
 			// @ts-expect-error TODO: fix types
 			rehypeTitleFigure,
@@ -155,7 +155,6 @@ export default defineConfig({
 				MarkdownContent: "./src/components/overrides/MarkdownContent.astro",
 				Sidebar: "./src/components/overrides/Sidebar.astro",
 				PageSidebar: "./src/components/overrides/PageSidebar.astro",
-				SiteTitle: "./src/components/overrides/SiteTitle.astro",
 				PageTitle: "./src/components/overrides/PageTitle.astro",
 				SocialIcons: "./src/components/overrides/SocialIcons.astro",
 				SkipLink: "./src/components/overrides/SkipLink.astro",
@@ -170,6 +169,7 @@ export default defineConfig({
 				"./src/mermaid.css",
 				"./src/table.css",
 				"./src/tailwind.css",
+				"./src/title.css",
 				"./src/tooltips.css",
 			],
 			pagination: false,