partial rationalization of docs

kodster28 · kodster28 · commit 58c9a424104f · 2025-10-09T10:48:04.000-05:00
diff --git a/src/content/docs/ai-gateway/tutorials/deploy-aig-worker.mdx b/src/content/docs/ai-gateway/tutorials/deploy-aig-worker.mdx
@@ -6,8 +6,6 @@ tags:
   - AI
   - JavaScript
 title: Deploy a Worker that connects to OpenAI via AI Gateway
-products:
-  - Workers
 description: Learn how to deploy a Worker that makes calls to OpenAI through AI Gateway
 ---
 
diff --git a/src/content/docs/analytics/graphql-api/tutorials/querying-workers-metrics.mdx b/src/content/docs/analytics/graphql-api/tutorials/querying-workers-metrics.mdx
@@ -1,9 +1,7 @@
 ---
 title: Querying Workers Metrics with GraphQL
 pcx_content_type: example
-products:
-  - Workers
-
+products: [workers]
 ---
 
 In this example, we are going to use the GraphQL Analytics API to query for Workers Metrics over a specified time period. We can query up to one month of data for dates up to three months ago.
@@ -127,4 +125,4 @@ https://api.cloudflare.com/client/v4/graphql \
 #=> }
 ```
 
-[^1]: Refer to [Configure an Analytics API token](/analytics/graphql-api/getting-started/authentication/api-token-auth/) for more information on configuration and permissions.
+[^1]: Refer to [Configure an Analytics API token](/analytics/graphql-api/getting-started/authentication/api-token-auth/) for more information on configuration and permissions.
diff --git a/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx b/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx
@@ -1,10 +1,7 @@
 ---
 pcx_content_type: tutorial
 title: Deploy a Browser Rendering Worker with Durable Objects
-products:
-  - Workers
-  - Durable Objects
-  - R2
+products: [workers, durable-objects, r2]
 difficulty: Beginner
 reviewed: 2023-09-28
 tags:
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/browser-cache-ttl.mdx b/src/content/docs/cache/how-to/cache-rules/examples/browser-cache-ttl.mdx
@@ -3,8 +3,6 @@ pcx_content_type: example
 summary: Browser Cache TTL
 title: Browser Cache TTL
 description: Browser Cache TTL
-products:
-  - Cache Rules
 ---
 
 import { Example, Render } from "~/components";
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/bypass-cache-on-cookie.mdx b/src/content/docs/cache/how-to/cache-rules/examples/bypass-cache-on-cookie.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Bypass Cache on Cookie
 title: Bypass Cache on Cookie
 description: Bypass Cache on Cookie
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example, Render } from "~/components";
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/cache-deception-armor.mdx b/src/content/docs/cache/how-to/cache-rules/examples/cache-deception-armor.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Cache Deception Armor
 title: Cache Deception Armor
 description: Cache Deception Armor
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example, Render } from "~/components";
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/cache-device-type.mdx b/src/content/docs/cache/how-to/cache-rules/examples/cache-device-type.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Cache by Device Type
 title: Cache by Device Type
 description: Cache by Device Type
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example, Render } from "~/components";
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/cache-everything-ignore-query-strings.mdx b/src/content/docs/cache/how-to/cache-rules/examples/cache-everything-ignore-query-strings.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Cache Everything while ignoring query strings
 title: Cache Everything while ignoring query strings
 description: Cache Everything while ignoring query strings
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example, Render } from "~/components";
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/cache-everything.mdx b/src/content/docs/cache/how-to/cache-rules/examples/cache-everything.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Cache Level (Cache Everything)
 title: Cache Level (Cache Everything)
 description: Cache Level (Cache Everything)
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example, Render } from "~/components";
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/cache-ttl-by-status-code.mdx b/src/content/docs/cache/how-to/cache-rules/examples/cache-ttl-by-status-code.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Cache TTL by status code
 title: Cache TTL by status code
 description: Cache TTL by status code
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example, Render } from "~/components";
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/custom-cache-key.mdx b/src/content/docs/cache/how-to/cache-rules/examples/custom-cache-key.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Custom Cache Key
 title: Custom Cache Key
 description: Custom Cache Key
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example, Render } from "~/components";
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/edge-ttl.mdx b/src/content/docs/cache/how-to/cache-rules/examples/edge-ttl.mdx
@@ -3,26 +3,25 @@ pcx_content_type: example
 summary: Edge Cache TTL
 title: Edge Cache TTL
 description: Edge Cache TTL
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
-import { Example } from "~/components"
+import { Example } from "~/components";
 
 [Create a cache rule](/cache/how-to/cache-rules/create-dashboard/) to adjust edge cache TTL for caching resources on Cloudflare edge to one day, for any hostname containing `example.com`:
 
 <Example>
 
-* **When incoming requests match**: Custom filter expression
-  * Using the Expression Builder:<br/>
+- **When incoming requests match**: Custom filter expression
+  - Using the Expression Builder:<br/>
     `Hostname contains "example.com"`
-  * Using the Expression Editor:<br/>
+  - Using the Expression Editor:<br/>
     `(http.host contains "example.com")`
 
-* **Then**:
-  * **Cache eligibility**: Eligible for cache
-  * **Setting**: Edge TTL
-    * Ignore cache-control header and use this TTL
-      * **Input time-to-live (TTL)**: *1 day*
+- **Then**:
+  - **Cache eligibility**: Eligible for cache
+  - **Setting**: Edge TTL
+    - Ignore cache-control header and use this TTL
+      - **Input time-to-live (TTL)**: _1 day_
 
 </Example>
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/origin-cache-control.mdx b/src/content/docs/cache/how-to/cache-rules/examples/origin-cache-control.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Origin Cache Control
 title: Origin Cache Control
 description: Origin Cache Control
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example } from "~/components"
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/query-string-sort.mdx b/src/content/docs/cache/how-to/cache-rules/examples/query-string-sort.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Query String Sort
 title: Query String Sort
 description: Query String Sort
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example } from "~/components"
diff --git a/src/content/docs/cache/how-to/cache-rules/examples/respect-strong-etags.mdx b/src/content/docs/cache/how-to/cache-rules/examples/respect-strong-etags.mdx
@@ -3,8 +3,7 @@ pcx_content_type: example
 summary: Respect Strong ETags
 title: Respect Strong ETags
 description: Respect Strong ETags
-products:
-  - Cache Rules
+products: [cache-rules]
 ---
 
 import { Example } from "~/components"
diff --git a/src/content/docs/cloudflare-one/tutorials/access-workers.mdx b/src/content/docs/cloudflare-one/tutorials/access-workers.mdx
@@ -4,9 +4,7 @@ category: 🔐 Access
 difficulty: Intermediate
 pcx_content_type: tutorial
 title: Create custom headers for Cloudflare Access-protected origins with Workers
-products:
-  - Workers
-  - Access
+products: [workers, access]
 tags:
   - JavaScript
 ---
diff --git a/src/content/docs/cloudflare-one/tutorials/r2-logs.mdx b/src/content/docs/cloudflare-one/tutorials/r2-logs.mdx
@@ -4,8 +4,7 @@ category: 🔐 Zero Trust
 difficulty: Beginner
 pcx_content_type: tutorial
 title: Use Cloudflare R2 as a Zero Trust log destination
-products:
-  - R2
+products: [r2]
 ---
 
 import { DashButton } from "~/components";
diff --git a/src/content/docs/d1/tutorials/build-a-comments-api.mdx b/src/content/docs/d1/tutorials/build-a-comments-api.mdx
@@ -3,8 +3,7 @@ reviewed: 2024-10-01
 difficulty: Intermediate
 pcx_content_type: tutorial
 title: Build a Comments API
-products:
-  - Workers
+products: [workers]
 tags:
   - Hono
   - JavaScript
diff --git a/src/content/docs/d1/tutorials/build-a-staff-directory-app.mdx b/src/content/docs/d1/tutorials/build-a-staff-directory-app.mdx
@@ -3,8 +3,7 @@ reviewed: 2024-03-21
 difficulty: Intermediate
 pcx_content_type: tutorial
 title: Build a Staff Directory Application
-products:
-  - Pages
+products: [pages]
 tags:
   - Hono
   - TypeScript
diff --git a/src/content/docs/d1/tutorials/build-an-api-to-access-d1.mdx b/src/content/docs/d1/tutorials/build-an-api-to-access-d1.mdx
@@ -3,8 +3,7 @@ reviewed: 2024-09-20
 difficulty: Intermediate
 pcx_content_type: tutorial
 title: Build an API to access D1 using a proxy Worker
-products:
-  - Workers
+products: [workers]
 tags:
   - Hono
   - TypeScript
diff --git a/src/content/docs/d1/tutorials/d1-and-prisma-orm.mdx b/src/content/docs/d1/tutorials/d1-and-prisma-orm.mdx
@@ -4,8 +4,7 @@ difficulty: Beginner
 content_type: Tutorial
 pcx_content_type: tutorial
 title: Query D1 using Prisma ORM
-products:
-  - Workers
+products: [workers]
 tags:
   - TypeScript
   - SQL
diff --git a/src/content/docs/hyperdrive/tutorials/serverless-timeseries-api-with-timescale.mdx b/src/content/docs/hyperdrive/tutorials/serverless-timeseries-api-with-timescale.mdx
@@ -3,8 +3,7 @@ reviewed: 2023-10-30
 difficulty: Beginner
 pcx_content_type: tutorial
 title: Create a serverless, globally distributed time-series API with Timescale
-products:
-  - Workers
+products:	[workers]
 tags:
   - PostgreSQL
   - TypeScript
diff --git a/src/content/docs/load-balancing/pools/cloudflare-pages-origin.mdx b/src/content/docs/load-balancing/pools/cloudflare-pages-origin.mdx
@@ -3,8 +3,7 @@ pcx_content_type: tutorial
 title: Use Pages as an origin for Load Balancing
 reviewed: 2024-07-03
 difficulty: Beginner
-products:
-  - Pages
+products: [pages]
 sidebar:
   order: 3
 
diff --git a/src/content/docs/pages/tutorials/use-r2-as-static-asset-storage-for-pages.mdx b/src/content/docs/pages/tutorials/use-r2-as-static-asset-storage-for-pages.mdx
@@ -3,8 +3,7 @@ reviewed: 2024-07-22
 difficulty: Intermediate
 pcx_content_type: tutorial
 title: Use R2 as static asset storage with Cloudflare Pages
-products:
-  - R2
+products: [r2]
 tags:
   - Hono
   - JavaScript
diff --git a/src/content/products/cache-rules.yaml b/src/content/products/cache-rules.yaml
@@ -0,0 +1,11 @@
+name: Cache Rules
+
+product:
+  title: Cache Rules
+  group: Application performance
+  url: /cache/how-to/cache-rules/
+  show: false
+
+meta:
+  title: Cloudflare Cache Rules docs
+  author: "@cloudflare"
