Merge remote-tracking branch 'upstream/production' into chore/formatting

Author: Cherry

.github/ISSUE_TEMPLATE/engineering.yml

@@ -2,7 +2,6 @@ name: Cloudflare docs website error(s)
 description: Report an issue with the live documentation website; for example, issues with content display, buggy browser behavior, etc.
 labels: ["engineering"]
 assignees:
-  - kodster28
   - KianNH
 body:
   - type: textarea

.github/actions/assign-pr/index.ts

@@ -80,7 +80,7 @@ async function list(
 			}
 
 			if (assignees.size === 0) {
-				assignees.add("kodster28");
+				assignees.add("haleycode");
 			}
 
 			// don't self-assign

.github/workflows/semgrep.yml

@@ -11,14 +11,14 @@ name: Semgrep config
 jobs:
   semgrep:
     name: semgrep/ci
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
     env:
       SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
       SEMGREP_URL: https://cloudflare.semgrep.dev
       SEMGREP_APP_URL: https://cloudflare.semgrep.dev
       SEMGREP_VERSION_CHECK_URL: https://cloudflare.semgrep.dev/api/check-version
     container:
-      image: returntocorp/semgrep
+      image: semgrep/semgrep
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - run: semgrep ci

README.md

@@ -35,9 +35,11 @@ This spawns a server that will be accessible via `http://localhost:1111` in your
 
 ### Recommendations
 
-Part of our application accesses the GitHub API (to populate the [Wrangler changelog](https://github.com/cloudflare/cloudflare-docs/blob/production/layouts/partials/wrangler-changelog.html)).
+Part of our application accesses the GitHub API (to populate the [Wrangler changelog](https://developers.cloudflare.com/workers/platform/changelog/wrangler/)).
 
+<!--
 Since GitHub gives a higher request limit to authenticated requests, you may want to add a [classic token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#personal-access-tokens-classic) with permissions for `repos:public_repo` to `/assets/secrets/github_token.txt`. The token value should be the only thing in your file.
+-->
 
 ## Deployment
 
@@ -61,12 +63,12 @@ Please note that we may use AI tools to help us review technical documentation,
 
 All commands are run from the root of the project, from a terminal:
 
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npx astro build`          | Build your production site to `./dist/`          |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+| Command                   | Action                                      |
+|:--------------------------|:--------------------------------------------|
+| `npm install`             | Installs dependencies                       |
+| `npm run dev`             | Starts local dev server at `localhost:1111` |
+| `npx astro build`         | Build your production site to `./dist/`     |
+| `npm run astro -- --help` | Get help using the Astro CLI                |
 
 ## 👀 Want to learn more?
 

package-lock.json

@@ -33,6 +33,8 @@
 		"@cloudflare/workers-types": "^4.20240903.0",
 		"@codingheads/sticky-header": "^1.0.2",
 		"@stoplight/json-schema-tree": "^4.0.0",
+		"@types/dompurify": "^3.0.5",
+		"@types/he": "^1.2.3",
 		"@types/node": "^20.16.1",
 		"@types/react": "^18.3.5",
 		"@types/react-dom": "^18.3.0",
@@ -42,15 +44,17 @@
 		"astro-icon": "^1.1.1",
 		"astro-live-code": "^0.0.3",
 		"date-fns": "^3.6.0",
+		"dompurify": "3.1.6",
 		"dot-prop": "^9.0.0",
 		"github-slugger": "^2.0.0",
 		"hastscript": "^9.0.0",
+		"he": "^1.2.0",
 		"instantsearch.css": "^8.5.0",
 		"instantsearch.js": "^4.74.0",
 		"littlefoot": "^4.1.1",
 		"lz-string": "^1.5.0",
 		"marked": "^14.1.1",
-		"mermaid": "^11.1.1",
+		"mermaid": "^11.3.0",
 		"node-html-parser": "^6.1.13",
 		"patch-package": "^8.0.0",
 		"prettier": "^3.3.3",

package.json

@@ -175,7 +175,40 @@ if (Astro.props.entry.data.external_link) {
 <script>
 	import mermaid from "mermaid";
 
-	mermaid.initialize({ startOnLoad: true, theme: "neutral" });
+	const diagrams = document.querySelectorAll<HTMLPreElement>("pre.mermaid");
+
+	let init = false;
+
+	async function render() {
+		const theme =
+			document.documentElement.getAttribute("data-theme") === "light"
+				? "neutral"
+				: "dark";
+
+		for (const diagram of diagrams) {
+			if (!init) {
+				diagram.setAttribute("data-diagram", diagram.textContent as string);
+			}
+
+			const def = diagram.getAttribute("data-diagram") as string;
+
+			mermaid.initialize({ startOnLoad: false, theme });
+			await mermaid
+				.render(`mermaid-${crypto.randomUUID()}`, def)
+				.then(({ svg }) => (diagram.innerHTML = svg));
+
+			diagram.setAttribute("data-processed", "true");
+		}
+
+		init = true;
+	}
+
+	const obs = new MutationObserver(() => render());
+
+	obs.observe(document.documentElement, {
+		attributes: true,
+		attributeFilter: ["data-theme"],
+	});
 </script>
 <script src="src/scripts/analytics.ts"></script>
 <Default {...Astro.props}><slot /></Default>

src/components/overrides/Head.astro

@@ -4,6 +4,7 @@ import Default from "@astrojs/starlight/components/PageSidebar.astro";
 import type { CollectionEntry } from "astro:content";
 import { entryToString } from "~/util/container";
 import { parse } from "node-html-parser";
+import he from "he";
 
 let rangeBetween = (x: number, y: number) =>
 	Array.from({ length: y - x + 1 }, (_, i) => i + x);
@@ -48,9 +49,11 @@ if (Astro.props.toc) {
 			for (const header of headers) {
 				const depth = headerDepth(header);
 
+				const title = he.decode(header.innerText);
+
 				if (depth === 2) {
 					Astro.props.toc.items.push({
-						text: header.innerText,
+						text: title,
 						slug: header.id,
 						depth,
 						children: [],
@@ -60,7 +63,7 @@ if (Astro.props.toc) {
 				}
 
 				Astro.props.toc.items.at(-1)?.children.push({
-					text: header.innerText,
+					text: title,
 					slug: header.id,
 					depth,
 					children: [],

src/components/overrides/PageSidebar.astro

@@ -23,7 +23,7 @@ entries:
   - publish_date: "2024-09-26"
     title: Evaluations
     description: |-
-      * **Configurations**: Use AI Gateway’s [Evaluations](/ai-gateway/observability/evaluations/index.mdx) to make informed decisions on how to optimize your AI application.
+      * **Configurations**: Use AI Gateway’s [Evaluations](/ai-gateway/evaluations) to make informed decisions on how to optimize your AI application.
 
   - publish_date: "2024-09-10"
     title: Custom costs

src/content/changelogs/ai-gateway.yaml

@@ -19,6 +19,13 @@ entries:
 
       During the initial beta, Storage API billing is not enabled for Durable Object classes using SQLite storage backend. SQLite-backed Durable Objects will incur [charges for requests and duration](/durable-objects/platform/pricing/#billing-metrics). We plan to enable Storage API billing for Durable Objects using SQLite storage backend in the first half of 2025 after advance notice with the following [pricing](/durable-objects/platform/pricing/#sqlite-storage-backend).
 
+  - publish_date: "2024-09-07"
+    title: New error message for overloaded Durable Objects
+    description: |-
+      Introduced a new overloaded error message for Durable Objects: "Durable Object is overloaded. Too many requests for the same object within a 10 second window."
+
+      This error message does not replace other types of overload messages that you may encounter for your Durable Object, and is only returned at more extreme levels of overload.
+
   - publish_date: "2024-06-24"
     description: |-
       [Exceptions](/durable-objects/best-practices/error-handling) thrown from Durable Object internal operations and tunneled to the caller may now be populated with a `.retryable: true` property if the exception was likely due to a transient failure, or populated with an `.overloaded: true` property if the exception was due to [overload](/durable-objects/observability/troubleshooting/#durable-object-is-overloaded).