Merge branch 'production' into ranbel/create-tunnel-api

Author: ranbel

.github/CODEOWNERS

@@ -17,7 +17,7 @@
 
 # AI
 
-/src/content/docs/agents/ @irvinebroque @rita3ko @elithrar @thomasgauvin @threepointone @kodster28 @KianNH
+/src/content/docs/agents/ @irvinebroque @rita3ko @elithrar @thomasgauvin @threepointone @harshil1712 @megaconfidence @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/vectorize/ @elithrar @vy-ton @sejoker @mchenco @cloudflare/pcx-technical-writing
@@ -47,6 +47,7 @@
 
 /src/content/changelog/ @cloudflare/pm-changelogs
 /src/assets/images/changelog/ @cloudflare/pm-changelogs
+/src/assets/images/ @cloudflare/pm-changelogs @cloudflare/pcx-technical-writing
 
 # Cloudflare One
 

.github/workflows/ci.yml

@@ -57,3 +57,10 @@ jobs:
 
       - name: Tests
         run: npm run test
+
+      - name: Post PR CI failure comment
+        if: always()
+        continue-on-error: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npx tsx bin/post-pr-ci-failure-comment/index.ts

.github/workflows/pr.yml

@@ -36,7 +36,7 @@ jobs:
           GH_REPO: ${{ github.repository }}
           NUMBER: ${{ github.event.pull_request.number }}
       - name: Internal comment
-        run: gh pr comment "$NUMBER" --body "Howdy and thanks for contributing to our repo. We review internal PRs with **1 week**. If it's something urgent or has been sitting without a comment, start a thread in the *Developer Docs* space internally."
+        run: gh pr comment "$NUMBER" --body "Howdy and thanks for contributing to our repo. We review internal PRs within **1 week**. If it's something urgent or has been sitting without a comment, start a thread in the *Developer Docs* space internally."
         if: steps.check_if_contributor_is_external.outputs.is_external == 'false'
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/publish-preview.yml

@@ -9,6 +9,7 @@ concurrency:
 
 jobs:
   publish:
+    if: github.repository == 'cloudflare/cloudflare-docs'
     runs-on: ubuntu-22.04
     permissions:
       contents: read

.nvmrc

@@ -0,0 +1 @@
+v22.9.0

astro.config.ts

@@ -8,14 +8,15 @@ import starlightLinksValidator from "starlight-links-validator";
 import icon from "astro-icon";
 import sitemap from "@astrojs/sitemap";
 import react from "@astrojs/react";
+
 import { readdir } from "fs/promises";
+import { fileURLToPath } from "url";
 
 import rehypeTitleFigure from "rehype-title-figure";
 import rehypeMermaid from "./src/plugins/rehype/mermaid.ts";
 import rehypeAutolinkHeadings from "./src/plugins/rehype/autolink-headings.ts";
 import rehypeExternalLinks from "./src/plugins/rehype/external-links.ts";
 import rehypeHeadingSlugs from "./src/plugins/rehype/heading-slugs.ts";
-import { fileURLToPath } from "url";
 
 async function autogenSections() {
 	const sections = (
@@ -36,7 +37,21 @@ async function autogenSections() {
 	});
 }
 
+async function autogenStyles() {
+	const styles = (
+		await readdir("./src/styles/", {
+			withFileTypes: true,
+			recursive: true,
+		})
+	)
+		.filter((x) => x.isFile())
+		.map((x) => x.parentPath + x.name);
+
+	return styles;
+}
+
 const sidebar = await autogenSections();
+const customCss = await autogenStyles();
 
 const runLinkCheck = process.env.RUN_LINK_CHECK || false;
 
@@ -96,18 +111,7 @@ export default defineConfig({
 				TableOfContents: "./src/components/overrides/TableOfContents.astro",
 			},
 			sidebar,
-			customCss: [
-				"./src/asides.css",
-				"./src/badges.css",
-				"./src/code.css",
-				"./src/footnotes.css",
-				"./src/headings.css",
-				"./src/input.css",
-				"./src/mermaid.css",
-				"./src/table.css",
-				"./src/tailwind.css",
-				"./src/title.css",
-			],
+			customCss,
 			pagination: false,
 			plugins: [
 				...(runLinkCheck

bin/fetch-warp-releases.js

@@ -2,7 +2,14 @@ import fs from "fs";
 import YAML from "yaml";
 import { marked } from "marked";
 
-const tracks = ["windows/ga", "windows/beta", "macos/ga", "macos/beta"];
+const tracks = [
+	"windows/ga",
+	"windows/beta",
+	"macos/ga",
+	"macos/beta",
+	"noble-intel/ga",
+	"noble-intel/beta",
+];
 
 const linesToRemove = [
 	"For related Cloudflare for Teams documentation please see: https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp",
@@ -11,11 +18,23 @@ const linesToRemove = [
 	"For Consumer documentation please see: https://developers.cloudflare.com/warp-client/",
 ];
 
-for (const track of tracks) {
+for (let track of tracks) {
 	fetch(`https://downloads.cloudflareclient.com/v1/update/json/${track}`)
 		.then((res) => res.json())
 		.then((data) => {
+			if (!data.items) {
+				console.warn(
+					`${track} has no releases: ${JSON.stringify(data, null, 2)}`,
+				);
+
+				return;
+			}
+
 			data.items.forEach((item) => {
+				if (track.startsWith("noble-intel")) {
+					track = track.replace("noble-intel", "linux");
+				}
+
 				const path = `./src/content/warp-releases/${track}/${item.version}.yaml`;
 
 				if (fs.existsSync(path)) {

bin/post-pr-ci-failure-comment/constants.ts

@@ -0,0 +1,4 @@
+export const GITHUB_ACTIONS_BOT_ID = 41898282;
+export const DOCS_BASE_URL = "https://developers.cloudflare.com";
+export const CONTENT_BASE_PATH = "src/content";
+export const PREVIEW_URL_REGEX = /^\*\*Preview URL:\*\* (.*)$/m;

bin/post-pr-ci-failure-comment/index.ts

@@ -0,0 +1,101 @@
+import * as core from "@actions/core";
+import * as github from "@actions/github";
+import type { PullRequestEvent } from "@octokit/webhooks-types";
+
+import { GITHUB_ACTIONS_BOT_ID } from "./constants";
+
+async function run(): Promise<void> {
+	try {
+		if (!process.env.GITHUB_TOKEN) {
+			core.setFailed(`Could not find GITHUB_TOKEN in env`);
+			process.exit();
+		}
+
+		const octokit = github.getOctokit(process.env.GITHUB_TOKEN);
+		const payload = github.context.payload as PullRequestEvent;
+
+		const { owner, repo } = github.context.repo;
+		const pullRequestNumber = payload.number;
+		const runId = github.context.runId;
+
+		const { data: run } = await octokit.rest.actions.listJobsForWorkflowRun({
+			owner,
+			repo,
+			run_id: runId,
+		});
+
+		const job = run.jobs.findLast((job) => job.name === "Compiles");
+
+		if (!job) {
+			core.setFailed(`Could not find a job called 'Compiles'`);
+			process.exit();
+		}
+
+		const failedStep = job.steps?.find((step) => step.conclusion === "failure");
+
+		if (failedStep) {
+			core.info(`Found failed step ${failedStep.name}`);
+		}
+
+		const conclusion = failedStep ? "failure" : "success";
+
+		const { data: comments } = await octokit.rest.issues.listComments({
+			owner,
+			repo,
+			issue_number: pullRequestNumber,
+			per_page: 100,
+		});
+
+		const existingComment = comments.find(
+			(comment) =>
+				comment.user?.id === GITHUB_ACTIONS_BOT_ID &&
+				comment.body?.includes("**CI run failed:**"),
+		);
+
+		if (existingComment) {
+			core.info(`Found existing comment with ID ${existingComment.id}`);
+		} else {
+			core.info(`No existing comment found`);
+		}
+
+		const url = `https://github.com/${owner}/${repo}/actions/runs/${runId}/job/${job.id}`;
+		const comment = `**CI run failed:** [build logs](${url})`;
+
+		if (conclusion === "failure") {
+			if (existingComment) {
+				core.info(
+					`Updating ${existingComment.id} with ${JSON.stringify(comment)}`,
+				);
+				await octokit.rest.issues.updateComment({
+					owner,
+					repo,
+					comment_id: existingComment.id,
+					body: comment,
+				});
+			} else {
+				core.info(`Creating new comment with ${JSON.stringify(comment)}`);
+				await octokit.rest.issues.createComment({
+					owner,
+					repo,
+					issue_number: pullRequestNumber,
+					body: comment,
+				});
+			}
+		} else if (conclusion === "success" && existingComment) {
+			core.info(`Removing ${existingComment.id}`);
+			await octokit.rest.issues.deleteComment({
+				owner,
+				repo,
+				issue_number: pullRequestNumber,
+				comment_id: existingComment.id,
+			});
+		}
+	} catch (error) {
+		if (error instanceof Error) {
+			core.setFailed(error.message);
+		}
+		process.exit();
+	}
+}
+
+run();