Merge branch 'main' into feat/view-markdown-button

Author: donjo

_components/Header.tsx

@@ -10,7 +10,7 @@ export default function (
 ) {
   const hrefIsInCurrentSection = (href: string, currentSection: string) => {
     return href.includes(currentSection) ||
-      href === "/services/" &&
+      href === "/deploy/" &&
         ["deploy", "subhosting", "services", "sandbox"].includes(
           currentSection,
         );

_config.ts

@@ -16,6 +16,8 @@ import title from "https://deno.land/x/lume_markdown_plugins@v0.7.0/title.ts";
 import toc from "https://deno.land/x/lume_markdown_plugins@v0.7.0/toc.ts";
 // See note below about GFM CSS
 // import { CSS as GFM_CSS } from "https://jsr.io/@deno/gfm/0.11.0/style.ts";
+import { walk } from "@std/fs";
+import { dirname } from "@std/path";
 import { log } from "lume/core/utils/log.ts";
 import anchor from "npm:markdown-it-anchor@9";
 import admonitionPlugin from "./markdown-it/admonition.ts";
@@ -28,6 +30,7 @@ import createRoutingMiddleware from "./middleware/functionRoutes.ts";
 import createGAMiddleware from "./middleware/googleAnalytics.ts";
 import redirectsMiddleware from "./middleware/redirects.ts";
 import createLlmsFilesMiddleware from "./middleware/llmsFiles.ts";
+import createMarkdownSourceMiddleware from "./middleware/markdownSource.ts";
 import { toFileAndInMemory } from "./utils/redirects.ts";
 import { cliNow } from "./timeUtils.ts";
 
@@ -73,6 +76,7 @@ const site = lume(
     server: {
       middlewares: [
         redirectsMiddleware,
+        createMarkdownSourceMiddleware({ root: "_site" }),
         createRoutingMiddleware(),
         createGAMiddleware({
           addr: { transport: "tcp", hostname: "localhost", port: 3000 },
@@ -230,6 +234,49 @@ site.addEventListener("afterBuild", async () => {
       log.error("Error generating LLMs files:" + error);
     }
   }
+
+  // Copy source .md files to _site so AI agents can request them directly.
+  // Excludes "reference/" (dynamically generated, no static .md source files).
+  const contentDirs = [
+    "runtime",
+    "deploy",
+    "sandbox",
+    "subhosting",
+    "examples",
+  ];
+  let mdCopied = 0;
+  let mdErrors = false;
+  for (const dir of contentDirs) {
+    // Skip directories that don't exist in this build
+    try {
+      await Deno.stat(dir);
+    } catch (error) {
+      if (!(error instanceof Deno.errors.NotFound)) {
+        log.error(`Error accessing content directory ${dir}: ${error}`);
+      }
+      continue;
+    }
+    try {
+      for await (
+        const entry of walk(dir, { exts: [".md"], includeDirs: false })
+      ) {
+        const destPath = site.dest(entry.path);
+        await Deno.mkdir(dirname(destPath), { recursive: true });
+        await Deno.copyFile(entry.path, destPath);
+        mdCopied++;
+      }
+    } catch (error) {
+      log.error(`Error copying markdown files from ${dir}: ${error}`);
+      mdErrors = true;
+    }
+  }
+  if (mdErrors) {
+    log.warn(
+      `Copied ${mdCopied} source markdown files to _site (some directories had errors, see above)`,
+    );
+  } else {
+    log.info(`Copied ${mdCopied} source markdown files to _site`);
+  }
 });
 
 site.copy("reference_gen/gen/deno/page.css", "/api/deno/page.css");

_data.json

@@ -13,8 +13,8 @@
       "href": "/examples/"
     },
     {
-      "name": "Services",
-      "href": "/services/",
+      "name": "Deno Deploy",
+      "href": "/deploy/",
       "style": "services"
     }
   ],

_includes/layout.tsx

@@ -51,6 +51,15 @@ export default function Layout(data: Lume.Data) {
           type="font/woff2"
           crossOrigin="anonymous"
         />
+        {data.page?.sourcePath?.endsWith(".md") && data.url !== "/" && (
+          <link
+            rel="alternate"
+            type="text/markdown"
+            href={data.page.sourcePath.endsWith("/index.md")
+              ? `/${data.page.sourcePath}`
+              : `${data.url.replace(/\/$/, "")}.md`}
+          />
+        )}
         <link rel="me" href="https://fosstodon.org/@deno_land" />
         <data.comp.OpenGraph
           title={data.title}

deploy/early-access/reference/builds.md

@@ -3,16 +3,12 @@ title: "About Deno Deploy"
 description: "Guide to Deno Deploy features, comparison with Deploy Classic, and getting started instructions for deployment."
 ---
 
-<a href="https://console.deno.com" class="docs-cta deploy-cta">Go to the Deno
-Deploy dashboard</a>
+<div class="lg:flex lg:flex-row lg:gap-8">
+   <img src="/deno-deploy.svg" alt="Deno Deploy logo" style="max-width: 120px" />
+      <p class="text-lg text-foreground-secondary mt-6">Deno's cloud services provide robust platforms for deploying and running JavaScript and TypeScript applications at global scale.<a href="https://console.deno.com" class="docs-cta deploy-cta mt-2">Go to the Deno
+Deploy dashboard</a></p>
 
-Deno Deploy comes with an easy to use dashboard at
-[console.deno.com](https://console.deno.com). In this dashboard, you can create
-new Deno Deploy organizations that contain Deno Deploy apps.
-
-Within a single organization, you cannot mix Deno Deploy apps with Deploy
-Classic projects. You can switch between different organizations using the
-organization picker in the top left of the dashboard.
+</div>
 
 ## What is Deno Deploy?
 
@@ -21,6 +17,11 @@ applications in the cloud (or self-hosted on your own infrastructure). It
 provides a management plane for deploying and running applications with the
 built-in CI or through integrations such as GitHub actions.
 
+Deno Deploy comes with an easy to use dashboard at
+[console.deno.com](https://console.deno.com). Here, you can create and host new
+apps, create and manage Deno Deploy organizations and manage and view your
+databases and app telemetry.
+
 ## Comparison to Deploy Classic
 
 Deno Deploy is a complete rework of Deploy Classic. It has a new dashboard, and

deploy/index.md

@@ -251,6 +251,22 @@ Environment variables configured for the "Build" context are available during
 builds, but variables from "Production" or "Development" contexts are not.
 [Learn more about environment variables](/deploy/reference/env_vars_and_contexts/).
 
+The following environment variables are additionally always available during
+builds:
+
+- `CI`: `true`
+- `DENO_DEPLOY`: `true` - Indicates that the code is running in Deno Deploy.
+- `DENO_DEPLOY_ORGANIZATION_ID`: The ID of the organization that owns the
+  application. This is a UUID.
+- `DENO_DEPLOY_ORGANIZATION_SLUG`: The slug of the organization that owns the
+  application. This is the human-readable identifier used in URLs that was set
+  when creating the organization.
+- `DENO_DEPLOY_APPLICATION_ID`: The ID of the application. This is a UUID.
+- `DENO_DEPLOY_APPLICATION_SLUG`: The slug of the application. This is the
+  human-readable identifier used in URLs that was set when creating the
+  application, or changed later in the application settings.
+- `DENO_DEPLOY_BUILD_ID`: The ID of the currently running build.
+
 Builders have the following resources available during the build process:
 
 - 2 vCPUs