npm - @shoalrun/cli - Versions diffs - 0.1.0-alpha.19 → 1.0.0 - Mend

@shoalrun/cli 0.1.0-alpha.19 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (219) hide show

package/agent-docs/documents.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "configDigest": "2a4f31a26f253a82d999fa1ed1d2a1220053ba53bea00435844ec76815e67bfa",
+  "configDigest": "29b56e216858565721d2a6773b9e22346061341ae078717ac05c19dd686f2f3b",
   "searchSynonyms": [
     [
       "walkthrough",
@@ -179,6 +179,8 @@
     "content/changelog/2026-11-04-product-publications.mdx",
     "content/changelog/2026-11-04-runtime-packaging.mdx",
     "content/changelog/2026-11-05-branding-security.mdx",
+    "content/changelog/2026-11-05-pdf-custom-languages.mdx",
+    "content/changelog/2026-11-06-code-api-references.mdx",
     "content/changelog/authoring-preview.mdx",
     "content/changelog/authoring-search.mdx",
     "content/changelog/authoring-tools.mdx",
@@ -191,6 +193,8 @@
     "content/chat-checks.mdx",
     "content/chat-settings.mdx",
     "content/cli-reference.mdx",
+    "content/code-api-reference-settings.mdx",
+    "content/code-api-references.mdx",
     "content/coding-agent-authoring.mdx",
     "content/color-modes.mdx",
     "content/component-action-link.mdx",
@@ -294,6 +298,7 @@
     "content/page-taxonomy.mdx",
     "content/palettes.mdx",
     "content/passage-index.mdx",
+    "content/pdf-export.mdx",
     "content/prepared-answers.mdx",
     "content/publications.mdx",
     "content/publish.mdx",
@@ -1065,7 +1070,7 @@
       "demo": false,
       "type": "overview",
       "title": "About Shoalrun",
-      "summary": "Learn what Shoalrun is exploring and where the alpha stands.",
+      "summary": "Learn what Shoalrun does and where the project is heading.",
       "subjectLifecycle": null,
       "variant": {
         "channel": "production",
@@ -1075,8 +1080,8 @@
       "url": "/about",
       "markdownUrl": "/about.md",
       "indexable": true,
-      "updated": "2026-10-27",
-      "contentDigest": "9f549033eb1b015dc5996c83bbff27e66acdaa771663cc82f995fde5afa84067",
+      "updated": "2026-11-07",
+      "contentDigest": "d0c9f68589f20722d5d6d5cb420dffe77f9f56434281c154687576d9c0f630fd",
       "breadcrumbs": [],
       "area": "project",
       "subarea": "project-overview",
@@ -1089,10 +1094,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 4618,
-      "markdownTokens": 988,
+      "markdownBytes": 4610,
+      "markdownTokens": 987,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "c24aa1fe37c68c1516cd4970511ec6c3c17248fe76729daeb1a8ae28aedb34ba"
+      "digest": "ed9bb0518dce7df45d2b97e5b3bcea1c4144d398f53e526fe97d08f105b57f69"
     },
     {
       "id": "guide.add-page",
@@ -1261,7 +1266,7 @@
       },
       "indexable": true,
       "updated": "2026-11-05",
-      "contentDigest": "e86c54d78777703e04921df54543d04cf9b2dff591ff1a544b4a160eba1736f6",
+      "contentDigest": "2d68c140d59812e28e9a81f2a5eabb93dbd27950552944d124917a1b68d357c5",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -1469,7 +1474,7 @@
       },
       "indexable": true,
       "updated": "2026-11-05",
-      "contentDigest": "13670da0d4baefbd00d3985633d47927616dfffd853f787dc82d3199578e8137",
+      "contentDigest": "f757831aaba022b44ec6ea0d4db70c7c5c1d6e989c712e8cee78ecd85e2836f2",
       "breadcrumbs": [
         {
           "label": "Reference",
@@ -1504,10 +1509,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 7167,
-      "markdownTokens": 1404,
+      "markdownBytes": 7982,
+      "markdownTokens": 1547,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "53ceae173c4d06b79c4bf78bd6b3da6d26c26848d9e5a3f93ec27a5cfe91a89c"
+      "digest": "88193fa88eda004e86188290f4adf468005dd8d212ac7b83b013462ac3ac4334"
     },
     {
       "id": "guide.agent-skills",
@@ -1537,7 +1542,7 @@
       },
       "indexable": true,
       "updated": "2026-11-05",
-      "contentDigest": "a22e276a8a8d8cdba278dc5513e20222be83b78eb8f87e1b63694f7db64781d6",
+      "contentDigest": "89f6c4232aab7519102a2cb02456b79e6861cdd83218df2c8059d3c90a491224",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -1579,10 +1584,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 4870,
-      "markdownTokens": 1139,
+      "markdownBytes": 5211,
+      "markdownTokens": 1213,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "69be93a9840c5cf31cc852c304f03a221145bb292eae66827b4555af7872e98c"
+      "digest": "7009e158931572e2b1d39e99972448985c4eef67b5a5f5371aedee4288e3ee87"
     },
     {
       "id": "guide.analytics",
@@ -1981,8 +1986,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "1c3a864a47a30cf8eec6daf48aa8f38cdaa2f413c3be51996a140633af580f9e",
+      "updated": "2026-11-07",
+      "contentDigest": "6663db0cdc6aa96b88b11a3ec12761a7411b966b426abfb329e303489f7eaf19",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -2026,10 +2031,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/put-the-spec-in-your-project.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "3a58eec1144b8ae4d24ef301c4049e1ae815531b598d27bed5740ddfcce84f5f",
-          "markdownBytes": 2574,
-          "markdownTokens": 622,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "8db56b7ec3fbb0b6cf2a6727e95b946501e4723b97762d7b2960474e52d3921c",
+          "markdownBytes": 2753,
+          "markdownTokens": 661,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2038,10 +2043,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/register-the-operation.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "c8b27454f840e035bcbb7bbc8c7c89d99c4b0c04e06c44586703a85fc10439d8",
-          "markdownBytes": 3383,
-          "markdownTokens": 825,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "3a2483e56472ad298ffc8ac6c351fa3d8bef8c9db82956f26610f55998a4939e",
+          "markdownBytes": 3562,
+          "markdownTokens": 864,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2050,10 +2055,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/author-the-reference-page.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "1733411604898555462db94d5bcb4f24e16f40bf81d57bfe88cc73579219f276",
-          "markdownBytes": 2707,
-          "markdownTokens": 646,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "96f619db648f9a20f345b9340c52a962325ef95065e64c92d5d5a3402b2d1476",
+          "markdownBytes": 2886,
+          "markdownTokens": 685,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2062,10 +2067,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/review-imported-content-before-publishing.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "1981984a492d0cbbeddc5dbfacc82a6bd3e2e016e088af459e2983357f0b9cf6",
-          "markdownBytes": 2986,
-          "markdownTokens": 696,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "8f761dcd3af9895155383fd2ea5a01f4ff5ffed3de5f127cdb6e48f2de57a25b",
+          "markdownBytes": 3165,
+          "markdownTokens": 735,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2074,10 +2079,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/build-and-verify-the-output.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "42eb0a295118c3f1386a8df5c7c2cfbe3a78b5622cf8331e535e3e683d8b993f",
-          "markdownBytes": 3038,
-          "markdownTokens": 738,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "60e42c5ecb5c7e8d823e8de6de81a635c65412f72f1205a9b33a2d653ad84d27",
+          "markdownBytes": 3217,
+          "markdownTokens": 777,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2086,10 +2091,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/what-readers-get.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "17589e3c65c7ea1b6b8eaa8b09dc14bbf5c645581d41a7c1d3c5edbc7ca42c57",
-          "markdownBytes": 2423,
-          "markdownTokens": 565,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "e9b80e4ef1846f4cabeffee759e3fa73a9853e865497c0959630dd06175db0b1",
+          "markdownBytes": 2602,
+          "markdownTokens": 604,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2098,10 +2103,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/next-steps.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "443a4685fc5dcf0ab366bb1094f46c9a6aa943115b1010e204a330709cdb0943",
-          "markdownBytes": 2997,
-          "markdownTokens": 709,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "23b36cd6313660da2a07829fda5ebaa0bc7ad7c38c41130f752170d2c8b00bf4",
+          "markdownBytes": 3176,
+          "markdownTokens": 748,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2110,10 +2115,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/inspect-the-machine-readable-contract.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "35bad09a9af8d7694278e3051d3963a74082681d3e97414712970cbf4a685ea1",
-          "markdownBytes": 2052,
-          "markdownTokens": 503,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "af761b74b50380edd83efa8c46883e6220ec81597d5873e1dd835129818678e7",
+          "markdownBytes": 2231,
+          "markdownTokens": 542,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2122,10 +2127,10 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/preview-a-small-api-reference.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "2dd32fab88ea32086b884692dedfcc78365ee308ad045e0e1cac6fce58b13b34",
-          "markdownBytes": 2224,
-          "markdownTokens": 548,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "006e12a6af657a48c3183112f67fe66b53d0ff3e885de7b59b0925d4ed2c9822",
+          "markdownBytes": 2403,
+          "markdownTokens": 587,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -2134,17 +2139,17 @@
           "depth": 2,
           "markdownUrl": "/publish/api-references.sections/related-reading.md",
           "parentMarkdownUrl": "/publish/api-references.md",
-          "parentDigest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689",
-          "digest": "7aac3c92fb14ef4bd622948bd31b63559f08c629c7fdc332cc9467b83ade33d4",
-          "markdownBytes": 2116,
-          "markdownTokens": 524,
+          "parentDigest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c",
+          "digest": "db1a8bae91852d2ff6464f3e22deb84d0a47aec526d6267c09a3a10413fe97ab",
+          "markdownBytes": 2295,
+          "markdownTokens": 563,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 11704,
-      "markdownTokens": 2644,
+      "markdownBytes": 11883,
+      "markdownTokens": 2683,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "23482a019ddbf92c71ec332d0ac6550f8bf40a2b8e2c3c8498e34bc6e9b29689"
+      "digest": "0ee588452f62ccf3c988d9cafc5a4d08afd69b1e9b1adf27a37f1a14b304e80c"
     },
     {
       "id": "guide.audit",
@@ -2317,8 +2322,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "113844bcf6336c38caadf8437f1e5543b0c33382d45fc5e0c284523ef99344e2",
+      "updated": "2026-11-07",
+      "contentDigest": "bf26c4cccd46cf46369cf9f5f28d9a44865c43190cdb303a998ca2e0c9fe9408",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -2362,10 +2367,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 3609,
-      "markdownTokens": 751,
+      "markdownBytes": 3603,
+      "markdownTokens": 750,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "77620593f2af059eaa80af1f2dc0dde9ab8b9739ecaf07db941e28c8df38a69c"
+      "digest": "ed16d5c8afe9db3f3046f9f2011b138a81631e8e12a41cb22d766f62fc3c5dea"
     },
     {
       "id": "guide.authoring-agent-workflow",
@@ -2621,8 +2626,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "039314a36477107c5e1ec112a89a9ac3ba8cac0beaa82944f6def22f284ae20f",
+      "updated": "2026-11-06",
+      "contentDigest": "e45f85839a9028ba157c6c3c5039b408daf62012b3943e28c827b6ab255d8492",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -2666,10 +2671,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 6529,
+      "markdownBytes": 6528,
       "markdownTokens": 1420,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "4edc7cd973596f36352f83908142252c782130168156cbdb97331d3763c12b23"
+      "digest": "708da4efec006a5f1b0028f6dd323f7a5f9c24f673c5e64e70e89a46d29d3aa6"
     },
     {
       "id": "guide.cards",
@@ -3601,6 +3606,142 @@
       "markdownTokenEncoding": "cl100k_base",
       "digest": "e1625bf7539c6486c66682a90b48536abe4d2a3ee15a6ff1e0aa36aaa83ba0f6"
     },
+    {
+      "id": "change.pdf-custom-languages",
+      "demo": false,
+      "type": "changelog-entry",
+      "title": "Styled PDFs and custom code languages",
+      "summary": "Print branded pages, export a complete PDF manual, and highlight your own code language.",
+      "subjectLifecycle": null,
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      },
+      "url": "/changelog/pdf-custom-languages",
+      "markdownUrl": "/changelog/pdf-custom-languages.md",
+      "navigationTab": {
+        "id": "project-updates",
+        "label": "Project",
+        "variant": {
+          "channel": "production",
+          "version": "current",
+          "language": "en"
+        },
+        "url": "/status",
+        "markdownUrl": "/status.md",
+        "indexUrl": "/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt"
+      },
+      "indexable": true,
+      "updated": "2026-11-06",
+      "contentDigest": "c8857bec63bc19acfe522744874bfd43ab8924b3e2d4663cabfea6d47f1388a8",
+      "breadcrumbs": [
+        {
+          "label": "Project",
+          "url": "/status"
+        },
+        {
+          "label": "Changelog"
+        },
+        {
+          "label": "beta.1: PDFs and code languages",
+          "url": "/changelog/pdf-custom-languages"
+        }
+      ],
+      "area": [
+        "publishing",
+        "components",
+        "appearance",
+        "authoring",
+        "project"
+      ],
+      "subarea": [
+        "publishing-builds",
+        "components-code",
+        "appearance-themes",
+        "authoring-agent-workflows",
+        "project-releases"
+      ],
+      "readerFilters": {},
+      "cardTargets": [],
+      "cardQueries": [],
+      "snippets": [],
+      "apiEmbeds": [],
+      "focusedContractUrl": null,
+      "focusedContractBytes": null,
+      "focusedContractDigest": null,
+      "sections": [],
+      "markdownBytes": 1858,
+      "markdownTokens": 487,
+      "markdownTokenEncoding": "cl100k_base",
+      "digest": "72923ab92ea77feeb6e3faa7cbc9f91c9328a0bd674369302ccbc694ab4dc4cd"
+    },
+    {
+      "id": "change.code-api-references",
+      "demo": false,
+      "type": "changelog-entry",
+      "title": "Shoalrun 1.0 — SDK references and smoother font loading",
+      "summary": "Generate code API references from source and docstrings, choose how readers browse them, and load custom fonts earlier.",
+      "subjectLifecycle": null,
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      },
+      "url": "/changelog/code-api-references",
+      "markdownUrl": "/changelog/code-api-references.md",
+      "navigationTab": {
+        "id": "project-updates",
+        "label": "Project",
+        "variant": {
+          "channel": "production",
+          "version": "current",
+          "language": "en"
+        },
+        "url": "/status",
+        "markdownUrl": "/status.md",
+        "indexUrl": "/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt"
+      },
+      "indexable": true,
+      "updated": "2026-11-07",
+      "contentDigest": "2a84b3560f02a64872fabc67d3484106ec7cdd32289cc60fedd09c71ef6b2254",
+      "breadcrumbs": [
+        {
+          "label": "Project",
+          "url": "/status"
+        },
+        {
+          "label": "Changelog"
+        },
+        {
+          "label": "1.0: SDK references and font loading",
+          "url": "/changelog/code-api-references"
+        }
+      ],
+      "area": [
+        "api",
+        "appearance",
+        "project"
+      ],
+      "subarea": [
+        "api-generation",
+        "appearance-themes",
+        "project-releases"
+      ],
+      "readerFilters": {},
+      "cardTargets": [],
+      "cardQueries": [],
+      "snippets": [],
+      "apiEmbeds": [],
+      "focusedContractUrl": null,
+      "focusedContractBytes": null,
+      "focusedContractDigest": null,
+      "sections": [],
+      "markdownBytes": 2241,
+      "markdownTokens": 538,
+      "markdownTokenEncoding": "cl100k_base",
+      "digest": "9aa7d3ac58ddeb38c3da21651672206ca6bcd8151af7258221bfe2f91c2a8998"
+    },
     {
       "id": "change.authoring-preview",
       "demo": false,
@@ -3823,8 +3964,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "274993bcd8689ca36ea9ffcd87551a247c39d1a57e3118a87430f6547021d73d",
+      "updated": "2026-11-07",
+      "contentDigest": "2f510e9c66b46917e567ab78719266e64548f1ecbf77cd864810138796c77c0f",
       "breadcrumbs": [
         {
           "label": "Project",
@@ -3842,7 +3983,9 @@
       "subarea": "project-releases",
       "readerFilters": {},
       "cardTargets": [
+        "change.code-api-references",
         "change.branding-security",
+        "change.pdf-custom-languages",
         "change.2026-11-04-runtime-packaging",
         "change.product-publications",
         "change.2026-11-03",
@@ -3880,10 +4023,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 5352,
-      "markdownTokens": 1407,
+      "markdownBytes": 5861,
+      "markdownTokens": 1547,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "1532677ae98407dca12b3efd6992a2c83297627908d176694e136fcdb7809ed3"
+      "digest": "8ae73bce4cfb198d48f5351ce8dd18ac2b6a21b45c131eafcd3b27b52adf3936"
     },
     {
       "id": "change.mcp-hosting",
@@ -3970,8 +4113,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "2ac8f42520a85105a537d777d621bdd4f642bb6beba1eb4f30728a19a8b0eaea",
+      "updated": "2026-11-06",
+      "contentDigest": "460b4d667da2ebdd09f005b1f4ae5950021d487b17fe4fdca9eac59d59356efb",
       "breadcrumbs": [
         {
           "label": "Project",
@@ -4006,10 +4149,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 5331,
-      "markdownTokens": 1095,
+      "markdownBytes": 5323,
+      "markdownTokens": 1093,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "a6e55a1a9e4e9d4bba033c44fa90adb508285d405f6dc4acf72d2416ba78f64d"
+      "digest": "e219fb748fe3c52ea495953c62f97f279cd944586a0603ff446e286a2be08394"
     },
     {
       "id": "change.search-and-tooltips",
@@ -4540,8 +4683,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "e8406bb26cc3c3de473c625c3eda88e2ecf23272a44215e6abd2000e8a04e691",
+      "updated": "2026-11-07",
+      "contentDigest": "8fa04fe33ea38dd80623ffcf3ce8cf2e6d98d1d5eedd9d370d15c8b5e7e0ff32",
       "breadcrumbs": [
         {
           "label": "Reference",
@@ -4578,8 +4721,8 @@
           "depth": 2,
           "markdownUrl": "/cli.sections/start-a-project.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "c3490306954e3482bf7214475d4ae1c6a03dd364e64c37c2e3b87f402f8332fa",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "dd1f3fd63c3ecd36e4c42ae6917da0d8533d42e9f51e63cb9486b1da14480bc4",
           "markdownBytes": 2852,
           "markdownTokens": 670,
           "markdownTokenEncoding": "cl100k_base"
@@ -4590,8 +4733,8 @@
           "depth": 2,
           "markdownUrl": "/cli.sections/build-and-serve.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "197dd259d8e6387aeefe7085700aefef61dc0d9ba9e108054e55f20bdb135418",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "0a4e58d20228f96a68c452652213ed9be590f7c492f0ac304c72cd2833088aa1",
           "markdownBytes": 12941,
           "markdownTokens": 2990,
           "markdownTokenEncoding": "cl100k_base"
@@ -4602,8 +4745,8 @@
           "depth": 2,
           "markdownUrl": "/cli.sections/author-pages.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "77c2954b84475f96dc5af70c06b79ca48644cff24f2bb4cc4ebdca0d4806221c",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "3e462c7e17ce8f6549375356266c259cf08f40ede9187b9d2eabadcfe25662dc",
           "markdownBytes": 7903,
           "markdownTokens": 1677,
           "markdownTokenEncoding": "cl100k_base"
@@ -4614,20 +4757,32 @@
           "depth": 2,
           "markdownUrl": "/cli.sections/inspect-config-and-operations.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "9b974d02a75da21e60c8e819a87effed4910039bdcd4c1ed82b10422ea8ad8bd",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "d0f410253ada3beacbf8baf453afbf74ebe9ff5e8098e0506e21ec496bcc81f2",
           "markdownBytes": 4260,
           "markdownTokens": 765,
           "markdownTokenEncoding": "cl100k_base"
         },
+        {
+          "id": "validate-code-reference-snapshots",
+          "title": "Validate code reference snapshots",
+          "depth": 2,
+          "markdownUrl": "/cli.sections/validate-code-reference-snapshots.md",
+          "parentMarkdownUrl": "/cli.md",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "88de7230491ba2ff0dd168c94cdb0c864987d08dfbf0ee419b697ebe6e0dda72",
+          "markdownBytes": 2409,
+          "markdownTokens": 583,
+          "markdownTokenEncoding": "cl100k_base"
+        },
         {
           "id": "audit-a-project-and-api-sources",
           "title": "Audit a project and API sources",
           "depth": 2,
           "markdownUrl": "/cli.sections/audit-a-project-and-api-sources.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "2109885b44608cc133f471ae385a15f5c3d256eb440523c5cbfdf4190bbe7a34",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "980e1a9269e2dd76357591abdb2cdce8d1743f26a7bc4f2dd089345682d70522",
           "markdownBytes": 6981,
           "markdownTokens": 1646,
           "markdownTokenEncoding": "cl100k_base"
@@ -4638,8 +4793,8 @@
           "depth": 2,
           "markdownUrl": "/cli.sections/npm-scripts-in-this-repository.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "618d45dd7346298be8372e0cdab255b962c2bb49f303505dba2744409bdc68af",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "99116648fd630f8b3136b54db36ea0f2ec12c90acdde6bd44a3385632cb03719",
           "markdownBytes": 4175,
           "markdownTokens": 878,
           "markdownTokenEncoding": "cl100k_base"
@@ -4650,8 +4805,8 @@
           "depth": 2,
           "markdownUrl": "/cli.sections/search-and-chat.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "3cc835746b224fa63ffd64f93d3e9a4a45f2f0ee6efc8a94b003466eff0adce9",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "a9a2188e82557f87440d4aafca9b5a08988374c1d50eacd499023c772e68c73e",
           "markdownBytes": 13964,
           "markdownTokens": 2988,
           "markdownTokenEncoding": "cl100k_base"
@@ -4662,8 +4817,8 @@
           "depth": 2,
           "markdownUrl": "/cli.sections/working-tree-authoring-tools.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "1081581eec3f57e9c3380c67339d79eabca3180c6272741185759ccd0f2e824e",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "b60fda85a77a72155f6c0dea5b541fd4732d7b65b73776813582ce83ff9089a2",
           "markdownBytes": 2890,
           "markdownTokens": 667,
           "markdownTokenEncoding": "cl100k_base"
@@ -4674,17 +4829,281 @@
           "depth": 2,
           "markdownUrl": "/cli.sections/related-reading.md",
           "parentMarkdownUrl": "/cli.md",
-          "parentDigest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523",
-          "digest": "6090089ed9c660d7b6373710908f4b0f25d703b71de162310d0e2656befa9518",
+          "parentDigest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d",
+          "digest": "785b18b7ceecb5920dfcf71c5d4cecde1439e61487d227994dfe12e7ff4aebc5",
           "markdownBytes": 1939,
           "markdownTokens": 483,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 43654,
-      "markdownTokens": 9183,
+      "markdownBytes": 44291,
+      "markdownTokens": 9321,
+      "markdownTokenEncoding": "cl100k_base",
+      "digest": "f34aef19d758d9a92a26ba6c093ab35f9cf7480c2b7a77307b93921d8b31c25d"
+    },
+    {
+      "id": "reference.code-api-references",
+      "demo": false,
+      "type": "reference",
+      "title": "Code API reference settings",
+      "summary": "Catalog configuration, converter snapshots, Python extraction limits, and generated reference behavior.",
+      "subjectLifecycle": null,
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      },
+      "url": "/api-docs/code-reference-settings",
+      "markdownUrl": "/api-docs/code-reference-settings.md",
+      "navigationTab": {
+        "id": "docs",
+        "label": "Docs",
+        "variant": {
+          "channel": "production",
+          "version": "current",
+          "language": "en"
+        },
+        "url": "/what-is-shoalrun",
+        "markdownUrl": "/what-is-shoalrun.md",
+        "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
+      },
+      "indexable": true,
+      "updated": "2026-11-06",
+      "availability": {
+        "since": "1.0.0"
+      },
+      "contentDigest": "fe028a21365c55583066361689081a7ead8e475ce78c8703c2e2180e23be1ca7",
+      "breadcrumbs": [
+        {
+          "label": "Docs",
+          "url": "/what-is-shoalrun"
+        },
+        {
+          "label": "Document an API"
+        },
+        {
+          "label": "Code API reference settings",
+          "url": "/api-docs/code-reference-settings"
+        }
+      ],
+      "area": "api",
+      "subarea": "api-generation",
+      "readerFilters": {
+        "focus": [
+          "configure"
+        ]
+      },
+      "cardTargets": [
+        "guide.code-api-references"
+      ],
+      "cardQueries": [
+        {
+          "component": "RelatedReading"
+        }
+      ],
+      "snippets": [],
+      "apiEmbeds": [],
+      "focusedContractUrl": null,
+      "focusedContractBytes": null,
+      "focusedContractDigest": null,
+      "sections": [
+        {
+          "id": "catalog-settings",
+          "title": "Catalog settings",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/catalog-settings.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "9576d49f52bd3954678ff82ac4bee9a6ad2772cd7ee0a0ab33bacebf4239b0f5",
+          "markdownBytes": 4048,
+          "markdownTokens": 743,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "complete-reference-page",
+          "title": "Complete reference page",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/complete-reference-page.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "cc2107c7dc77a184813958bdeeb875a0b1b1d239cfa7c7a6d9199fa8502e2323",
+          "markdownBytes": 2370,
+          "markdownTokens": 520,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "publication-sources",
+          "title": "Publication sources",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/publication-sources.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "96b851750aeb41a3bf87a5d57665f56300e57b7248c792fc98a5643d6244c530",
+          "markdownBytes": 2133,
+          "markdownTokens": 506,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "metadata-and-selection",
+          "title": "Metadata and selection",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/metadata-and-selection.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "8970dca13e3727ad141315d08b58208be59bd7ebc08742f1914abdb9d38344b9",
+          "markdownBytes": 2198,
+          "markdownTokens": 479,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "converter-snapshot",
+          "title": "Converter snapshot",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/converter-snapshot.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "1dc218ded3515df31ec5e933661283002799f3e848ce1c687a77611ba81c1ae0",
+          "markdownBytes": 2669,
+          "markdownTokens": 657,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "symbol-fields",
+          "title": "Symbol fields",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/symbol-fields.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "47a49b3ee1b576b6360cc40e74791650abdab4f04814746d1922c9dde8d923da",
+          "markdownBytes": 4833,
+          "markdownTokens": 798,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "descriptions-type-links-and-source-links",
+          "title": "Descriptions, type links, and source links",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/descriptions-type-links-and-source-links.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "b64ee32c7dc82ee978f329ed88d37cb334dfd8581b953708a47e7d10423dec2f",
+          "markdownBytes": 2365,
+          "markdownTokens": 539,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "python-adapter-limits",
+          "title": "Python adapter limits",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/python-adapter-limits.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "5fecca505799782b56cb1de13990aef568757af186e1f624b67b4033c5d7e8d3",
+          "markdownBytes": 2243,
+          "markdownTokens": 503,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "html-markdown-and-agents",
+          "title": "HTML, Markdown, and agents",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/html-markdown-and-agents.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "6bab992872e218d2dae14ba7bc041cbe3f9cc1998da71b22af41df76db8c2b51",
+          "markdownBytes": 2248,
+          "markdownTokens": 496,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "related-reading",
+          "title": "Related reading",
+          "depth": 2,
+          "markdownUrl": "/api-docs/code-reference-settings.sections/related-reading.md",
+          "parentMarkdownUrl": "/api-docs/code-reference-settings.md",
+          "parentDigest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51",
+          "digest": "c531372c8bc531e8e72fd08944802b05b161b3cf997687b3e9d0248703bb3454",
+          "markdownBytes": 1403,
+          "markdownTokens": 345,
+          "markdownTokenEncoding": "cl100k_base"
+        }
+      ],
+      "markdownBytes": 13423,
+      "markdownTokens": 2374,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "f02c9c73d7e8469bdcaad3d03bd10d9144714a2c59f822c0dea7d3c05cd75523"
+      "digest": "683c0d7d83e7379af9d383be33b20157875842275c444bf6c9b6f8991d92ce51"
+    },
+    {
+      "id": "guide.code-api-references",
+      "demo": false,
+      "type": "how-to",
+      "title": "Generate code API references",
+      "summary": "Turn Python source and docstrings into SDK reference pages, with separate, grouped, or complete-page layouts.",
+      "subjectLifecycle": null,
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      },
+      "url": "/api-docs/code-references",
+      "markdownUrl": "/api-docs/code-references.md",
+      "navigationTab": {
+        "id": "docs",
+        "label": "Docs",
+        "variant": {
+          "channel": "production",
+          "version": "current",
+          "language": "en"
+        },
+        "url": "/what-is-shoalrun",
+        "markdownUrl": "/what-is-shoalrun.md",
+        "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
+      },
+      "indexable": true,
+      "updated": "2026-11-07",
+      "availability": {
+        "since": "1.0.0"
+      },
+      "contentDigest": "863666f320fe916f38f283b10af86b51ccbe1682b470c54ccb3f7595b689f71d",
+      "breadcrumbs": [
+        {
+          "label": "Docs",
+          "url": "/what-is-shoalrun"
+        },
+        {
+          "label": "Document an API"
+        },
+        {
+          "label": "Generate code API references",
+          "url": "/api-docs/code-references"
+        }
+      ],
+      "area": "api",
+      "subarea": "api-generation",
+      "readerFilters": {
+        "focus": [
+          "write"
+        ]
+      },
+      "cardTargets": [
+        "guide.api-references",
+        "reference.code-api-references"
+      ],
+      "cardQueries": [
+        {
+          "component": "RelatedReading"
+        }
+      ],
+      "snippets": [],
+      "apiEmbeds": [],
+      "focusedContractUrl": null,
+      "focusedContractBytes": null,
+      "focusedContractDigest": null,
+      "sections": [],
+      "markdownBytes": 9387,
+      "markdownTokens": 1936,
+      "markdownTokenEncoding": "cl100k_base",
+      "digest": "a7ae9986be38b666e9f6e33116f74ca20029beb1228b6abe2b282863a61feb9e"
     },
     {
       "id": "guide.coding-agent-authoring",
@@ -5260,8 +5679,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "28b607d43cfffa82129cfab0a847b28093b91f6d1a85a9766c7234c788af7654",
+      "updated": "2026-11-06",
+      "contentDigest": "98d8af660a52bbba71b2f17fe7f63fe1c59e3a20aaa7a7773f50e10b7e7fafd3",
       "breadcrumbs": [
         {
           "label": "Reference",
@@ -5297,10 +5716,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 6601,
-      "markdownTokens": 1433,
+      "markdownBytes": 8553,
+      "markdownTokens": 1879,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "df37703b34887d5378e752eaa427f12f3f653b402e4d41b3b7ee4a325fcf7f1c"
+      "digest": "4ef222efeaf632304499fcc607bfa847137f276956038ae1c841933befafd64d"
     },
     {
       "id": "guide.component.collapsible",
@@ -6838,7 +7257,7 @@
       },
       "indexable": true,
       "updated": "2026-11-05",
-      "contentDigest": "b35509fc034cffcc009b3bd2c94222ff9d5cbc9d1ebc829883f7bdf75b98c81f",
+      "contentDigest": "1b67c667ce2ffb6a185c808e5d79704b48a795d49006b95d4eb458c2b080d6ab",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -6906,8 +7325,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "6b64ab6cad978bd088e5f7a2db904dc88c6eac05144fb2ae737d95d0eb9de247",
+      "updated": "2026-11-07",
+      "contentDigest": "21055f3927415c0cb233c3f0a091baa3fbb80ec447aed85fc0b9c92624996272",
       "breadcrumbs": [
         {
           "label": "Reference",
@@ -6943,10 +7362,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 9832,
-      "markdownTokens": 1893,
+      "markdownBytes": 10227,
+      "markdownTokens": 1974,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "c5a46ecf979c6bdf3935d5fabb7122735c546ec967201dd763032ac8412ad9e5"
+      "digest": "4e7c34e80feb82883b4ddf553901fd3bd42cdfa26c4d0803ddb32d70ab1ff9c8"
     },
     {
       "id": "reference.config-content",
@@ -7224,7 +7643,7 @@
       "demo": false,
       "type": "reference",
       "title": "Output and export settings",
-      "summary": "Configure metadata providers, application exports, Markdown headers, and discovery indexes.",
+      "summary": "Configure application exports, PDF styling, Markdown headers, and discovery indexes.",
       "subjectLifecycle": null,
       "variant": {
         "channel": "production",
@@ -7246,8 +7665,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "d4946abe5430b184b86ae91ce80cb2c5b20c1c4878780deb7a0513dbcac1302d",
+      "updated": "2026-11-06",
+      "contentDigest": "544040f6cddcb1fbce74757a7e5712466663aae4af44718d389681c8ea104f43",
       "breadcrumbs": [
         {
           "label": "Reference",
@@ -7283,16 +7702,28 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [
+        {
+          "id": "pdf-output",
+          "title": "PDF output",
+          "depth": 2,
+          "markdownUrl": "/config/outputs.sections/pdf-output.md",
+          "parentMarkdownUrl": "/config/outputs.md",
+          "parentDigest": "9c7d5ee316eb08d7c7a679292bceebb68ce92c6b94b7aa9d1b71332631cdd89c",
+          "digest": "965f215b47d297f12f0d8adb4b8d6e29d7664fbd14158127da1598bf7743bf67",
+          "markdownBytes": 2554,
+          "markdownTokens": 587,
+          "markdownTokenEncoding": "cl100k_base"
+        },
         {
           "id": "metadata",
           "title": "metadata",
           "depth": 2,
           "markdownUrl": "/config/outputs.sections/metadata.md",
           "parentMarkdownUrl": "/config/outputs.md",
-          "parentDigest": "421cb9789a3e89c6459818a7843769d4cf01d1fb521bc9afa9c6b5d35347a03e",
-          "digest": "c08902a0416f992d246060b86350956433983640e8a2196a02de7a7a970bc52c",
-          "markdownBytes": 2030,
-          "markdownTokens": 456,
+          "parentDigest": "9c7d5ee316eb08d7c7a679292bceebb68ce92c6b94b7aa9d1b71332631cdd89c",
+          "digest": "8c63077841dce52cfae0446d2aadfe323506175ad6843c0eaf45efb7305679f1",
+          "markdownBytes": 2023,
+          "markdownTokens": 457,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -7301,10 +7732,10 @@
           "depth": 2,
           "markdownUrl": "/config/outputs.sections/exports.md",
           "parentMarkdownUrl": "/config/outputs.md",
-          "parentDigest": "421cb9789a3e89c6459818a7843769d4cf01d1fb521bc9afa9c6b5d35347a03e",
-          "digest": "8474137649ed27dad8a33e7c73f8cf6e9b819bd39cdd1ac3b8bd3ce61c817d55",
-          "markdownBytes": 5400,
-          "markdownTokens": 986,
+          "parentDigest": "9c7d5ee316eb08d7c7a679292bceebb68ce92c6b94b7aa9d1b71332631cdd89c",
+          "digest": "759ca5858779273bd59836cb22300b4c1c73fd750d75dd51bf994ec653a425b8",
+          "markdownBytes": 5393,
+          "markdownTokens": 987,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -7313,17 +7744,17 @@
           "depth": 2,
           "markdownUrl": "/config/outputs.sections/related-reading.md",
           "parentMarkdownUrl": "/config/outputs.md",
-          "parentDigest": "421cb9789a3e89c6459818a7843769d4cf01d1fb521bc9afa9c6b5d35347a03e",
-          "digest": "3115a5499a728a0468f548840127d780fce74156f472600aeae06353533a45f4",
-          "markdownBytes": 1557,
-          "markdownTokens": 356,
+          "parentDigest": "9c7d5ee316eb08d7c7a679292bceebb68ce92c6b94b7aa9d1b71332631cdd89c",
+          "digest": "5722d23d538923966fe60b375ca23b6e854b2f4b60cf89fed86d051ba4f5352c",
+          "markdownBytes": 1550,
+          "markdownTokens": 357,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 12011,
-      "markdownTokens": 2281,
+      "markdownBytes": 13397,
+      "markdownTokens": 2545,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "421cb9789a3e89c6459818a7843769d4cf01d1fb521bc9afa9c6b5d35347a03e"
+      "digest": "9c7d5ee316eb08d7c7a679292bceebb68ce92c6b94b7aa9d1b71332631cdd89c"
     },
     {
       "id": "reference.config-publishing",
@@ -7552,8 +7983,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "4ee7cb6125f79de776ec8ace10f1391efa68256d49cd78ae8fae8098629d3ae1",
+      "updated": "2026-11-07",
+      "contentDigest": "0007a02ed417ee039f47acf63fe391618372f3652dfa17c3901951a810a169fa",
       "breadcrumbs": [
         {
           "label": "Reference",
@@ -7591,9 +8022,9 @@
       "focusedContractDigest": null,
       "sections": [],
       "markdownBytes": 8302,
-      "markdownTokens": 1803,
+      "markdownTokens": 1807,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "1d41ab0be914623eb230c6a2954f80f50a3ddcbcf9b43b3e2c2d31d6012503aa"
+      "digest": "498381b68cfa64a7094305d530b54245c29672517b1fdd51ab7c0a16bc729440"
     },
     {
       "id": "guide.configuration",
@@ -7622,8 +8053,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "77a18fdd41f68fa83c3b88364ab1dc5f66030eefbb460b1665c0f9ac378c6de0",
+      "updated": "2026-11-07",
+      "contentDigest": "d0755bffc9169872603d7fa935f70be729249622037cd4bd15c16df465730622",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -7667,8 +8098,8 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/understand-the-three-stages.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "fcea04d3758620b250c90079e08ca3f4e83ef374a9645e51463a15ecfc923e0e",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "dfce40775d9087555377b13f3808b8a446cc31118878dfdf1d7e881caa4ade45",
           "markdownBytes": 3758,
           "markdownTokens": 741,
           "markdownTokenEncoding": "cl100k_base"
@@ -7679,10 +8110,10 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/start-with-one-working-file.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "b17d25ecfb3bc0825f68a7e88a06ec269557bb16df57cd58bad385a307be81d0",
-          "markdownBytes": 2893,
-          "markdownTokens": 701,
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "221f6919538f389a979757bb87989c0603cbbbbcd624c29199309dd23e3408ed",
+          "markdownBytes": 2884,
+          "markdownTokens": 698,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -7691,8 +8122,8 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/extract-a-section-with-include.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "329de0642bc298b88c42bd90aa027d3ff896158b2390a0e231d86d0b5750d6e5",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "c9d77597ed804eed9be2dfa48504dc674a3d014c78c4402f496c9eff6684b2e7",
           "markdownBytes": 3101,
           "markdownTokens": 704,
           "markdownTokenEncoding": "cl100k_base"
@@ -7703,8 +8134,8 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/share-defaults-through-extends.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "d806d10362d8ed97d5ae3c9dc3f8da8c7284082c5ca8eaca87e470b51a56dec2",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "05c8558af86a41ea8910e407e02b96992ca05cbd5f036be26ad343a0041f4d54",
           "markdownBytes": 5192,
           "markdownTokens": 1133,
           "markdownTokenEncoding": "cl100k_base"
@@ -7715,8 +8146,8 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/change-inherited-lists-deliberately.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "80e7e5b92fba1d42ad89636492b490b6b9602b2d9b79e81b2623889a71e7145b",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "cf52ea0d1afa6b362f16654a543ea97d9c149fb67bdc5cc8ab580276476e82f3",
           "markdownBytes": 3585,
           "markdownTokens": 809,
           "markdownTokenEncoding": "cl100k_base"
@@ -7727,8 +8158,8 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/understand-where-paths-point.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "96896801e232b0454f9acbed8914d65d5be2fa4a395b03a88c9d99e5b9a612f6",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "3eae415867c9a314696359f3cb920eed711ab5e65db8dd8d74d86d1f66deba9a",
           "markdownBytes": 3480,
           "markdownTokens": 724,
           "markdownTokenEncoding": "cl100k_base"
@@ -7739,8 +8170,8 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/separate-config-inheritance-from-page-metadata.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "893f8aa365bc25c79d4df825f0651c74c99019b72507e61e72a47ebdc5db29bd",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "212c7bb97de7b886a9114c724310361bdf10e8edb925e15ce6c1f4568f346f58",
           "markdownBytes": 3438,
           "markdownTokens": 724,
           "markdownTokenEncoding": "cl100k_base"
@@ -7751,8 +8182,8 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/inspect-and-validate-changes.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "afa528f2953225a1a0160097a58301db512e0dbd756d4aa03f258842d97138d9",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "00453391b7dd2f33a3ec69a695247e592eb5f440a62a00c7b8ff22643c3c998a",
           "markdownBytes": 5496,
           "markdownTokens": 1086,
           "markdownTokenEncoding": "cl100k_base"
@@ -7763,8 +8194,8 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/build-several-sites-from-shared-content.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "ca657f69ebe87bf5d9c5f03e9f494a214dd28af239142ebe44ed93525cf07875",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "bfd668ef5b84a35f33697c3d5ef279d804dfdedc8c3612101a0242d88460a752",
           "markdownBytes": 2020,
           "markdownTokens": 457,
           "markdownTokenEncoding": "cl100k_base"
@@ -7775,17 +8206,17 @@
           "depth": 2,
           "markdownUrl": "/configuration.sections/related-reading.md",
           "parentMarkdownUrl": "/configuration.md",
-          "parentDigest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33",
-          "digest": "0a0cb5c596c0652b259b03b11916d86a3a393f024fdd75eacac128345c2637f7",
+          "parentDigest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50",
+          "digest": "34b7044c862cefe4c1f25f6f54b397233663ea121827f15e2d1607f864f739e7",
           "markdownBytes": 2018,
           "markdownTokens": 459,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 20509,
-      "markdownTokens": 4169,
+      "markdownBytes": 20500,
+      "markdownTokens": 4166,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "80583cd9a92ac79274939bc53f54a93359bb50ab3538901fe07bda840a750a33"
+      "digest": "d2b2dde0b18d05eddc28bcfc148ad6b60b38994ac029dd3334e323c6e9bb1f50"
     },
     {
       "id": "guide.site-mcp",
@@ -8319,7 +8750,7 @@
       },
       "indexable": true,
       "updated": "2026-11-05",
-      "contentDigest": "a84c63142bf052b3c2e3f4fccd98ee98341276aceb864b409da93982f958869f",
+      "contentDigest": "2038237a62f09be8aeba5c55e976e997563b1d911b130ae4081fd111beadc6db",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -8362,10 +8793,10 @@
           "depth": 2,
           "markdownUrl": "/publish/content-export.sections/prerequisites.md",
           "parentMarkdownUrl": "/publish/content-export.md",
-          "parentDigest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d",
-          "digest": "0d65d9fe68a02f190193112fb2d1da77a0fd5db0264bd2080b31f1164437d63a",
-          "markdownBytes": 2531,
-          "markdownTokens": 561,
+          "parentDigest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12",
+          "digest": "4a762be6043ead6b75232538fad6a12e273f028b7f9b42534612ac9c71357278",
+          "markdownBytes": 2805,
+          "markdownTokens": 615,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -8374,10 +8805,10 @@
           "depth": 2,
           "markdownUrl": "/publish/content-export.sections/check-the-result.md",
           "parentMarkdownUrl": "/publish/content-export.md",
-          "parentDigest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d",
-          "digest": "9b7c6eb5181c2e582d25c45d5282b9b472640820c743e5d065527922ca89c515",
-          "markdownBytes": 1512,
-          "markdownTokens": 344,
+          "parentDigest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12",
+          "digest": "ba11c537ab16beb34e7ab99c60db06e7edc0de7d4de7fff71423da17f7c11610",
+          "markdownBytes": 1786,
+          "markdownTokens": 398,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -8386,10 +8817,10 @@
           "depth": 2,
           "markdownUrl": "/publish/content-export.sections/what-the-representations-retain.md",
           "parentMarkdownUrl": "/publish/content-export.md",
-          "parentDigest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d",
-          "digest": "b66b3eb84e625ea4234b809569153b4f84527897345cb911f3f7cbe5b510c5f8",
-          "markdownBytes": 3884,
-          "markdownTokens": 691,
+          "parentDigest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12",
+          "digest": "996ba4e668931f44998b0ce270db914fb10c7e3eeb1f8a0aaffca2bb8c88ef2f",
+          "markdownBytes": 4158,
+          "markdownTokens": 745,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -8398,10 +8829,10 @@
           "depth": 2,
           "markdownUrl": "/publish/content-export.sections/assets-downloads-and-notices.md",
           "parentMarkdownUrl": "/publish/content-export.md",
-          "parentDigest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d",
-          "digest": "f3ae00c9b40a85c5124b1575e26dfbf74d17de6a892ca9e0268534f752a7139a",
-          "markdownBytes": 2240,
-          "markdownTokens": 505,
+          "parentDigest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12",
+          "digest": "83a0ae461212c1c73a3768d1b84d63c1400cab3676e0d6aa7a9dbeeb628062bb",
+          "markdownBytes": 2514,
+          "markdownTokens": 559,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -8410,10 +8841,10 @@
           "depth": 2,
           "markdownUrl": "/publish/content-export.sections/review-exported-api-material.md",
           "parentMarkdownUrl": "/publish/content-export.md",
-          "parentDigest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d",
-          "digest": "801aa0c31471f71ad6e512b8ded11b9bccc5d470e00c231bc2a5cce9da747949",
-          "markdownBytes": 2204,
-          "markdownTokens": 495,
+          "parentDigest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12",
+          "digest": "505229a80a902ac4e534d63408dd9277c9e621103d28039e77976def87b57fab",
+          "markdownBytes": 2478,
+          "markdownTokens": 549,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -8422,10 +8853,10 @@
           "depth": 2,
           "markdownUrl": "/publish/content-export.sections/inspect-the-manifest.md",
           "parentMarkdownUrl": "/publish/content-export.md",
-          "parentDigest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d",
-          "digest": "bca0b7543d794f597a9b3d7791ade93d497a3321b958b301231e5edf2697b401",
-          "markdownBytes": 2239,
-          "markdownTokens": 501,
+          "parentDigest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12",
+          "digest": "4b4f5ec4c69dac954eacc0841eeefab05b8a26945a8d7b14e82e5be4af3beb8e",
+          "markdownBytes": 2513,
+          "markdownTokens": 555,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -8434,10 +8865,10 @@
           "depth": 2,
           "markdownUrl": "/publish/content-export.sections/try-the-help-drawer-example.md",
           "parentMarkdownUrl": "/publish/content-export.md",
-          "parentDigest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d",
-          "digest": "825f417045db400cd0507e4944f4ba9deec513cc816f422115d2b8ab43b492f0",
-          "markdownBytes": 2009,
-          "markdownTokens": 463,
+          "parentDigest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12",
+          "digest": "05fe0b475564f0290584fcc147b5d2d22604046fd0e7a623c1ea88017b44cca2",
+          "markdownBytes": 2283,
+          "markdownTokens": 517,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -8446,17 +8877,17 @@
           "depth": 2,
           "markdownUrl": "/publish/content-export.sections/related-reading.md",
           "parentMarkdownUrl": "/publish/content-export.md",
-          "parentDigest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d",
-          "digest": "4fc7e3eafbfa1ea7cd12e1b9b0b0ed7c8c8d11063d58aec6c5e84896774345f1",
-          "markdownBytes": 1683,
-          "markdownTokens": 391,
+          "parentDigest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12",
+          "digest": "31625255da2bdf4f2608e13b757a60bf4670d22e72b7c66c7b627a93ca06a8d9",
+          "markdownBytes": 1957,
+          "markdownTokens": 445,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 16766,
-      "markdownTokens": 3375,
+      "markdownBytes": 17040,
+      "markdownTokens": 3429,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "f0ceca011c0d419a161bbbad6c945b0985a49b03ed0651422ff9d3621837909d"
+      "digest": "e7a061a029e56b3028d4ec762712ab252d7bd4db7d1481fe8d7f87f92d1c7d12"
     },
     {
       "id": "reference.content-manifest",
@@ -10845,8 +11276,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/examples-tab-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "811e9bcaf7ccd2c176f76f5a9d0d96cbe1c606875fbff6baf3105722fab67088",
+      "updated": "2026-11-07",
+      "contentDigest": "26efd7fa5b6798d2ddef3fb02942e2f01669bd1ef9a3d7c0b3619cd14b391419",
       "breadcrumbs": [
         {
           "label": "Examples",
@@ -10888,10 +11319,10 @@
           "depth": 2,
           "markdownUrl": "/config/examples.sections/feature-showcase.md",
           "parentMarkdownUrl": "/config/examples.md",
-          "parentDigest": "d4a52e8197a88a273d9c81bce126128b5531a21f3c46a3102ac01d98f5035258",
-          "digest": "18fca1c53e3ba0ddebe5a4fe097bad50ade955bb2e1029d385a3f6c78fc16af7",
-          "markdownBytes": 3266,
-          "markdownTokens": 785,
+          "parentDigest": "67662031e046723d74447a0760fd568d40ce33cdd1a0e5ecaf056350395fbb86",
+          "digest": "d45352329481e7f0c616f8d4515ae2b693d2473738ff5ca17ea3b0ba5965c67f",
+          "markdownBytes": 3248,
+          "markdownTokens": 779,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -10900,10 +11331,10 @@
           "depth": 2,
           "markdownUrl": "/config/examples.sections/minimal-site.md",
           "parentMarkdownUrl": "/config/examples.md",
-          "parentDigest": "d4a52e8197a88a273d9c81bce126128b5531a21f3c46a3102ac01d98f5035258",
-          "digest": "6862a0579aefe4744644634821b6f3369641048f516d5d69594beb071ab74f99",
-          "markdownBytes": 3135,
-          "markdownTokens": 774,
+          "parentDigest": "67662031e046723d74447a0760fd568d40ce33cdd1a0e5ecaf056350395fbb86",
+          "digest": "8ee5c0e45e1bd1ed3f932fff54e222a3579d452b5681244ba50726c4406a4587",
+          "markdownBytes": 3126,
+          "markdownTokens": 771,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -10912,10 +11343,10 @@
           "depth": 2,
           "markdownUrl": "/config/examples.sections/parcel-api-documentation.md",
           "parentMarkdownUrl": "/config/examples.md",
-          "parentDigest": "d4a52e8197a88a273d9c81bce126128b5531a21f3c46a3102ac01d98f5035258",
-          "digest": "d4d75e2f9f3189fb7aa59f2fc9721838f9546252cc29c7952ff6d261ec944eec",
-          "markdownBytes": 5809,
-          "markdownTokens": 1388,
+          "parentDigest": "67662031e046723d74447a0760fd568d40ce33cdd1a0e5ecaf056350395fbb86",
+          "digest": "60d2a05b5171c3da9125765e2a184e17b2c53dabb8e249804615421ce4fdc2d9",
+          "markdownBytes": 5800,
+          "markdownTokens": 1385,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -10924,10 +11355,10 @@
           "depth": 2,
           "markdownUrl": "/config/examples.sections/multilingual-help-center.md",
           "parentMarkdownUrl": "/config/examples.md",
-          "parentDigest": "d4a52e8197a88a273d9c81bce126128b5531a21f3c46a3102ac01d98f5035258",
-          "digest": "8db0c999236a48c9c8dfc7141b0b776d9ce127c8bb48e34148f36797b3df0301",
-          "markdownBytes": 4099,
-          "markdownTokens": 1012,
+          "parentDigest": "67662031e046723d74447a0760fd568d40ce33cdd1a0e5ecaf056350395fbb86",
+          "digest": "65558aed6a43aa09765a4ae0e06cb6cea555a043f1f723f661cef76c9f646e6c",
+          "markdownBytes": 4090,
+          "markdownTokens": 1009,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -10936,10 +11367,10 @@
           "depth": 2,
           "markdownUrl": "/config/examples.sections/shared-company-preset.md",
           "parentMarkdownUrl": "/config/examples.md",
-          "parentDigest": "d4a52e8197a88a273d9c81bce126128b5531a21f3c46a3102ac01d98f5035258",
-          "digest": "cc0e4d77e81e5fafeaca6ebaac9771016e1c56fb18900590bd81d7d58a800305",
-          "markdownBytes": 4563,
-          "markdownTokens": 1105,
+          "parentDigest": "67662031e046723d74447a0760fd568d40ce33cdd1a0e5ecaf056350395fbb86",
+          "digest": "e57474e337b54c4228a9b077d2f3739736eca16c466a1a972efef38fb613f280",
+          "markdownBytes": 4554,
+          "markdownTokens": 1102,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -10948,17 +11379,17 @@
           "depth": 2,
           "markdownUrl": "/config/examples.sections/related-reading.md",
           "parentMarkdownUrl": "/config/examples.md",
-          "parentDigest": "d4a52e8197a88a273d9c81bce126128b5531a21f3c46a3102ac01d98f5035258",
-          "digest": "6a39377581a081e52ecb9d789f015047f4532783de0dfc84b871d637ce033081",
-          "markdownBytes": 2593,
-          "markdownTokens": 622,
+          "parentDigest": "67662031e046723d74447a0760fd568d40ce33cdd1a0e5ecaf056350395fbb86",
+          "digest": "c849586370666734ca432a2bfc4374014e4991d9190c9d67444e26526312c3be",
+          "markdownBytes": 2584,
+          "markdownTokens": 619,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 12044,
-      "markdownTokens": 2893,
+      "markdownBytes": 12026,
+      "markdownTokens": 2887,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "d4a52e8197a88a273d9c81bce126128b5531a21f3c46a3102ac01d98f5035258"
+      "digest": "67662031e046723d74447a0760fd568d40ce33cdd1a0e5ecaf056350395fbb86"
     },
     {
       "id": "guide.explore",
@@ -11045,8 +11476,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "3f0778a069a48912c6a54856bf3fb6065f5e02871ae588d8204b61894fbf6018",
+      "updated": "2026-11-07",
+      "contentDigest": "03fbf12a946e4543983c18e4cc475818308aa9fa8efc7243c796a7614e75b900",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -11071,10 +11502,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 6054,
-      "markdownTokens": 999,
+      "markdownBytes": 7302,
+      "markdownTokens": 1213,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "2c2d26740e8c713e1c4a34cb4d0bcca31a18f0e6b69d32e2bfc816a47993b076"
+      "digest": "e8915a88c4f1c367a5a8fb6d8ebc5d179f082636f01e8da38ce8ba1cb812f950"
     },
     {
       "id": "guide.focused-contracts",
@@ -11239,7 +11670,7 @@
       },
       "indexable": true,
       "updated": "2026-11-05",
-      "contentDigest": "23f5daa7cad2eea8633534878a397fb14ee088b3c5f785d527afd2e4807ee13f",
+      "contentDigest": "1c9e03dc734097b4225c33b8f2eb96c072243a7580b42dabd12d905a18cbd6b4",
       "breadcrumbs": [
         {
           "label": "Reference",
@@ -11281,7 +11712,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/identify-and-route-a-page.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "ab2993b889f3476ece23ffe9087a49ccefbbe266446e6249190d2bb602172bf6",
           "markdownBytes": 3549,
           "markdownTokens": 708,
@@ -11293,7 +11724,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/choose-a-publication-and-visibility.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "18166614a76e8e990ef835425d28e4e8c74bb763751830bd25f93bab527a32c6",
           "markdownBytes": 5737,
           "markdownTokens": 937,
@@ -11305,10 +11736,10 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/categorize-connect-and-present-the-page.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
-          "digest": "15174c6f2045832340ac9931c03a081b454451ba88f19c2fd3d20315c9d3055c",
-          "markdownBytes": 12822,
-          "markdownTokens": 1833,
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
+          "digest": "527b1f7a9cc66c84d9af467a6e5b97be51c7ed3d19c10d082446646ba31789cd",
+          "markdownBytes": 13152,
+          "markdownTokens": 1882,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -11317,7 +11748,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/control-output-details.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "781f2ce028763e152bfb6e9f120a05bbcca618e6e5709d9c3a289059013aec6a",
           "markdownBytes": 3863,
           "markdownTokens": 753,
@@ -11329,7 +11760,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/project-defined-fields.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "802a236819fb79dcc1692bf9198bf4f578b753c4e7e82a8997696063418801e6",
           "markdownBytes": 3930,
           "markdownTokens": 786,
@@ -11341,7 +11772,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/global-defaults-and-enforced-values.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "4bc5fecd91d8379213f8c4b1b9a93d282bcbc4e73f295097833d0eee14854343",
           "markdownBytes": 2559,
           "markdownTokens": 545,
@@ -11353,7 +11784,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/feature-availability.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "34fa1a8d25d7232858d3bbb22796766075f7740b7a5538ae17a5f5b666a15c65",
           "markdownBytes": 3799,
           "markdownTokens": 823,
@@ -11365,7 +11796,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/product-publication-fields.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "e98795cbe5d00fea0fee8745654070ac1d5b244f7d574584535284b7575eed91",
           "markdownBytes": 2894,
           "markdownTokens": 631,
@@ -11377,7 +11808,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/use-the-local-files-while-authoring.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "a5e1fcd3514525209c53d432fda6b9db4b95c5e7acd464016ddc43d2ea3d8999",
           "markdownBytes": 2729,
           "markdownTokens": 594,
@@ -11389,7 +11820,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/when-the-files-update.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "1ecbdb7e20ddad1cb2c5c8923f497d90d9fb27d3440749fd9a1e66deb74d6e72",
           "markdownBytes": 2397,
           "markdownTokens": 531,
@@ -11401,7 +11832,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/point-agents-to-it.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "7c9fa924d348480ac4485b91730fd83f33398cd76933eec9f509552d0055b7f3",
           "markdownBytes": 2585,
           "markdownTokens": 573,
@@ -11413,7 +11844,7 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/html-markdown-and-agents.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "9cf350353efff08813905315c4daaeb275d64b7c26d292d133f5a95e9efdf732",
           "markdownBytes": 2489,
           "markdownTokens": 536,
@@ -11425,17 +11856,17 @@
           "depth": 2,
           "markdownUrl": "/author/frontmatter-reference.sections/related-reading.md",
           "parentMarkdownUrl": "/author/frontmatter-reference.md",
-          "parentDigest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e",
+          "parentDigest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6",
           "digest": "6763af61ca0efeeecac8ce1693a610a8f5c94a85a9c797c3fbbe13d830477529",
           "markdownBytes": 2434,
           "markdownTokens": 534,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 26806,
-      "markdownTokens": 4321,
+      "markdownBytes": 27136,
+      "markdownTokens": 4370,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "d9362c15f0db036b50831ac8062c1631c3ec2de999dd89872634117aa2ba7d7e"
+      "digest": "a5210970403864ee0c9d976e32cfb22c667460447a412adbf4ae5b911285c3c6"
     },
     {
       "id": "guide.frontmatter",
@@ -11797,8 +12228,8 @@
       "url": "/",
       "markdownUrl": "/index.md",
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "65764466927aef685017f42adf4c543cd2562cba7df5e822739c9fc1b0f02c1b",
+      "updated": "2026-11-06",
+      "contentDigest": "1fe1f67cf6666b3a8117f5393802bfe5ce9d80a91c79d8d5b88f02317f83a06e",
       "breadcrumbs": [],
       "area": "project",
       "subarea": "project-overview",
@@ -11829,10 +12260,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 11661,
-      "markdownTokens": 2494,
+      "markdownBytes": 11652,
+      "markdownTokens": 2493,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "5e196a4805e2433bcbb78ab5f990c2626d66bab968ac324debba4e36d90158c0"
+      "digest": "e46651c5fda52031b63dbe442b4e5aab3ffb15eb7b2427d8ac4d11b7ab1e0210"
     },
     {
       "id": "guide.host-adapters",
@@ -14191,6 +14622,168 @@
       "markdownTokenEncoding": "cl100k_base",
       "digest": "76d5a440a90a9f08e5f015f1045fc1e46a12873ec614f924647206fb198c4098"
     },
+    {
+      "id": "guide.pdf-export",
+      "demo": false,
+      "type": "how-to",
+      "title": "Export styled PDFs",
+      "summary": "Export a page or publication as a PDF and offer an optional page download.",
+      "subjectLifecycle": null,
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      },
+      "url": "/publish/pdf",
+      "markdownUrl": "/publish/pdf.md",
+      "navigationTab": {
+        "id": "docs",
+        "label": "Docs",
+        "variant": {
+          "channel": "production",
+          "version": "current",
+          "language": "en"
+        },
+        "url": "/what-is-shoalrun",
+        "markdownUrl": "/what-is-shoalrun.md",
+        "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
+      },
+      "indexable": true,
+      "updated": "2026-11-06",
+      "availability": {
+        "since": "0.1.0-beta.1"
+      },
+      "contentDigest": "f4bd886997b236ca5c39ec22368ce855a06bdeeec82a3343ad1b964e781c3eaf",
+      "breadcrumbs": [
+        {
+          "label": "Docs",
+          "url": "/what-is-shoalrun"
+        },
+        {
+          "label": "Publish and maintain"
+        },
+        {
+          "label": "Export styled PDFs",
+          "url": "/publish/pdf"
+        }
+      ],
+      "area": "publishing",
+      "subarea": "publishing-builds",
+      "readerFilters": {
+        "focus": [
+          "configure"
+        ]
+      },
+      "cardTargets": [],
+      "cardQueries": [],
+      "snippets": [],
+      "apiEmbeds": [],
+      "focusedContractUrl": null,
+      "focusedContractBytes": null,
+      "focusedContractDigest": null,
+      "sections": [
+        {
+          "id": "prerequisites",
+          "title": "Prerequisites",
+          "depth": 2,
+          "markdownUrl": "/publish/pdf.sections/prerequisites.md",
+          "parentMarkdownUrl": "/publish/pdf.md",
+          "parentDigest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a",
+          "digest": "0e2b82789682f056518f0ff163e31b28d39795edf3a4310bc9d7124190e81150",
+          "markdownBytes": 1877,
+          "markdownTokens": 453,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "export-a-page-or-publication",
+          "title": "Export a page or publication",
+          "depth": 2,
+          "markdownUrl": "/publish/pdf.sections/export-a-page-or-publication.md",
+          "parentMarkdownUrl": "/publish/pdf.md",
+          "parentDigest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a",
+          "digest": "f243d85b21568fdc744e409ecf31e3b88a5e4dfbb0861fbe031844d1be5930b0",
+          "markdownBytes": 2708,
+          "markdownTokens": 636,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "apply-print-styling",
+          "title": "Apply print styling",
+          "depth": 2,
+          "markdownUrl": "/publish/pdf.sections/apply-print-styling.md",
+          "parentMarkdownUrl": "/publish/pdf.md",
+          "parentDigest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a",
+          "digest": "3429146822404d0ef144775bee4bf1d596a8d52051cf169f3355b1595d174d69",
+          "markdownBytes": 3090,
+          "markdownTokens": 777,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "offer-browser-page-printing",
+          "title": "Offer browser page printing",
+          "depth": 2,
+          "markdownUrl": "/publish/pdf.sections/offer-browser-page-printing.md",
+          "parentMarkdownUrl": "/publish/pdf.md",
+          "parentDigest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a",
+          "digest": "5359a901d34c1660ad82ea4df3ec9817d9dd5f1092497c30d1cb33b23145ca13",
+          "markdownBytes": 3299,
+          "markdownTokens": 755,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "publish-an-optional-manual-download",
+          "title": "Publish an optional manual download",
+          "depth": 2,
+          "markdownUrl": "/publish/pdf.sections/publish-an-optional-manual-download.md",
+          "parentMarkdownUrl": "/publish/pdf.md",
+          "parentDigest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a",
+          "digest": "a60c8cf7c2dccb92f0b069afe30b43c2441852e287bbdf3e1c2633209d7e888a",
+          "markdownBytes": 2233,
+          "markdownTokens": 516,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "offer-direct-downloads-through-a-node-server",
+          "title": "Offer direct downloads through a Node server",
+          "depth": 2,
+          "markdownUrl": "/publish/pdf.sections/offer-direct-downloads-through-a-node-server.md",
+          "parentMarkdownUrl": "/publish/pdf.md",
+          "parentDigest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a",
+          "digest": "9cbd700a6521f5e58e0462035fd6ffdff45473ea840ab86f9c7577523961cf2f",
+          "markdownBytes": 2828,
+          "markdownTokens": 649,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "check-the-result",
+          "title": "Check the result",
+          "depth": 2,
+          "markdownUrl": "/publish/pdf.sections/check-the-result.md",
+          "parentMarkdownUrl": "/publish/pdf.md",
+          "parentDigest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a",
+          "digest": "51a8904206baba8f8dcb4bbfacb8e5e4daf3baac06742afae5efe974f4f7f413",
+          "markdownBytes": 2096,
+          "markdownTokens": 486,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "html-markdown-and-agents",
+          "title": "HTML, Markdown, and agents",
+          "depth": 2,
+          "markdownUrl": "/publish/pdf.sections/html-markdown-and-agents.md",
+          "parentMarkdownUrl": "/publish/pdf.md",
+          "parentDigest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a",
+          "digest": "12d7f6b1cac0dd653a39c690b601d0ae399b12f51cb77fd41ae7d533327df8d3",
+          "markdownBytes": 2131,
+          "markdownTokens": 470,
+          "markdownTokenEncoding": "cl100k_base"
+        }
+      ],
+      "markdownBytes": 12237,
+      "markdownTokens": 2622,
+      "markdownTokenEncoding": "cl100k_base",
+      "digest": "cb1863e4ad7413d21678ae31b274a7f520e4ddc96e06db8b1b0521a6b47c635a"
+    },
     {
       "id": "guide.prepared-answers",
       "demo": false,
@@ -14458,7 +15051,7 @@
       },
       "indexable": true,
       "updated": "2026-11-05",
-      "contentDigest": "fd4b8d8ad386bffb1897d200eb556fed9376af858637c0207dfebf8346d54907",
+      "contentDigest": "2bb86d25e66cd41e133b638eeb15da7be6000b5d28f55ebd4743fcbd78ab7e16",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -14497,10 +15090,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 6167,
-      "markdownTokens": 1352,
+      "markdownBytes": 6524,
+      "markdownTokens": 1423,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "92763f5d46f9739f441b7e50a0c143cadc9273ec35d44ec81da1adc2b8ffbcc2"
+      "digest": "0120ba4271c2b382c05bbb985a10b9b4e432354edaa196009617a658fe5ba92c"
     },
     {
       "id": "guide.reader-filters",
@@ -14530,7 +15123,7 @@
       },
       "indexable": true,
       "updated": "2026-11-05",
-      "contentDigest": "5fe86b056f0f6399421f395a96b1c62bc2e009ead778d6ec7ce00e39b21f4375",
+      "contentDigest": "65f12f1d712890c649b817897fa6221b6fcb8d0879073f9ef177ec4beb1d3949",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -16741,8 +17334,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "3ea2dba97524a65d8f77400399df41f7cdfb4d9ff514184aa89f814a7e5b042e",
+      "updated": "2026-11-07",
+      "contentDigest": "c782fe5ca7df6ca902839f33883cef4400df41ecc4317a522c3ff8de8add154e",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -16784,10 +17377,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/prerequisites.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "de603391b0793362cbe1bd5d2ef80b84c4afed02d3b1d95bafeeac92af72ed8f",
-          "markdownBytes": 1517,
-          "markdownTokens": 382,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "dc419445fcb6626dd66ed068fe8de2ab0d0be6055ef77c838bb0a41cf83db80d",
+          "markdownBytes": 1542,
+          "markdownTokens": 389,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16796,10 +17389,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/start-your-own-project.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "751e32429dd577b26a2fa92eddaec5edf60b6ad090803f51d3faa0b54a8ebc9d",
-          "markdownBytes": 1979,
-          "markdownTokens": 505,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "6f227f4af53b3f42a11e4ebb1d51461ee5119bf8b06a9f52a9df4ee31f637545",
+          "markdownBytes": 1994,
+          "markdownTokens": 509,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16808,10 +17401,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/create-a-page.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "4005b7a3d12895bce59e8df22c4656568c0c8907ce84e920b696537cd5907cbe",
-          "markdownBytes": 4405,
-          "markdownTokens": 995,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "b0e432b8364daf3cfb0a79dcb79c03a02267f4335dc33fc8916b1bde756aecca",
+          "markdownBytes": 4430,
+          "markdownTokens": 1002,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16820,10 +17413,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/add-the-page-to-navigation.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "de810a4f4e5324c08e80c53acc1a9b0f88a029c8e21632c4728bfc1bef1049a2",
-          "markdownBytes": 1798,
-          "markdownTokens": 451,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "287e9e1dfdc90827e4b389ecfefed4ae9b24d82d982bd223e21c0a691bd59ad3",
+          "markdownBytes": 1823,
+          "markdownTokens": 458,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16832,10 +17425,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/build-and-check-both-outputs.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "de3df660f8783fe3e55c738ed9ba5715f23a4cb9c06ca5957611030dcff8bc3d",
-          "markdownBytes": 2340,
-          "markdownTokens": 592,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "78ae6565086cc9af9aef617e0b50c87faa874d9ced30a02458c93e979de649e5",
+          "markdownBytes": 2365,
+          "markdownTokens": 599,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16844,10 +17437,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/make-it-yours.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "f7563c7ead6e020fa624547501c64880cd9d3fd3c44a3b55077394f74b69c730",
-          "markdownBytes": 1950,
-          "markdownTokens": 493,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "2b5099478d6f1ff2c9b7835cae3b985cf84e8a80eedbea49a55a56ae8a749167",
+          "markdownBytes": 1975,
+          "markdownTokens": 500,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16856,10 +17449,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/migrating-from-github-packages.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "21cfc4987c6517fc8b6d75dc30e4ec2709f38103ccabc2685f2563beeb576c2a",
-          "markdownBytes": 1794,
-          "markdownTokens": 447,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "c387ac0239ac6fef90156da8ca41870253aee7e6d936e90b67229bb8bf10b17f",
+          "markdownBytes": 1819,
+          "markdownTokens": 454,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16868,10 +17461,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/build-this-site.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "921a9d2920f9432ef6889adccd0a287745e23fc1773e3d11a0b705fb7c3bc6dd",
-          "markdownBytes": 1492,
-          "markdownTokens": 371,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "28be58140085dbc46a8490279b06b0197798b05a2d787fe0a55df5690ae14f6d",
+          "markdownBytes": 1517,
+          "markdownTokens": 378,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16880,10 +17473,10 @@
           "depth": 2,
           "markdownUrl": "/start.sections/check-writing-style.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "bff979cbcec77be314888c2c5bab91e77af44d65757a0ec3b39dd5ef02392c7e",
-          "markdownBytes": 1402,
-          "markdownTokens": 355,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "cbd3a92fa4f8785caa1f68db70438a7c9296f9d2e0b9316e5b76432337d9a366",
+          "markdownBytes": 1427,
+          "markdownTokens": 362,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -16892,17 +17485,17 @@
           "depth": 2,
           "markdownUrl": "/start.sections/related-reading.md",
           "parentMarkdownUrl": "/start.md",
-          "parentDigest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba",
-          "digest": "5e3f3014a7f1ae840b5c157840cfe6cb47e6508e6302fe500f291394a371fa77",
-          "markdownBytes": 1923,
-          "markdownTokens": 489,
+          "parentDigest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9",
+          "digest": "fbf9df75775741c9bad88b57d3183329b47daa40c0351b2a948c96287afdc5e6",
+          "markdownBytes": 1948,
+          "markdownTokens": 496,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 9106,
-      "markdownTokens": 2161,
+      "markdownBytes": 9121,
+      "markdownTokens": 2165,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "2915c5bcfcb7803ae81318b1a9fc1474fa59f53c9339bae63e1def51bf30c9ba"
+      "digest": "de9adec68f61ae5330b74e64ce67d9301e380dc431b66df9f2998a03d32217d9"
     },
     {
       "id": "guide.status",
@@ -16931,8 +17524,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "78ae3580f23996ad49e3da1bbe0ddd563629953792472ca446eede3324092a8a",
+      "updated": "2026-11-07",
+      "contentDigest": "b153150ae2e8c2cebbc94058e3f2c2ef45c91641f8795f05eccad8d64697a16f",
       "breadcrumbs": [
         {
           "label": "Project",
@@ -16967,10 +17560,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 8642,
-      "markdownTokens": 1850,
+      "markdownBytes": 9292,
+      "markdownTokens": 1990,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "c054cdd3cbee079afc8d3a98da7705d3272772368dfbce2315dbde470289aba2"
+      "digest": "7da698ed8670debd60fd34934be806b8d43792330774a52306e8cc6794ac0e12"
     },
     {
       "id": "guide.templates",
@@ -17263,8 +17856,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "d1b85e4f0d4aa9e2dbd29ad96eca22b2e28055114c913de65ca5d2884a2ffb5e",
+      "updated": "2026-11-07",
+      "contentDigest": "7e9b62e51a73f7e6810944fcc4655c19b8c803d3ffc39da9e494bf9d1641b5fb",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -17302,10 +17895,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 7176,
-      "markdownTokens": 1734,
+      "markdownBytes": 7763,
+      "markdownTokens": 1843,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "2c4eb856479750d531a5c2b7333dd1e9bb32a0c1f7e881aa8d2446881da05071"
+      "digest": "744ee42ab325dc9ad7e555c774cb15ddd44b05269a7e99f9235880bae9e946fd"
     },
     {
       "id": "guide.troubleshooting",
@@ -17522,8 +18115,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/docs-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "3d9611bb2cae44b1fbd68e1b9d5aa967a6f17f034c2f1653a06133b8b11270ab",
+      "updated": "2026-11-07",
+      "contentDigest": "89ca3d6c90bc64c39757ba8fb65311772fe4a8b3769c017af7e9b5eed8449b06",
       "breadcrumbs": [
         {
           "label": "Docs",
@@ -17557,10 +18150,10 @@
       "focusedContractBytes": null,
       "focusedContractDigest": null,
       "sections": [],
-      "markdownBytes": 4190,
-      "markdownTokens": 927,
+      "markdownBytes": 4184,
+      "markdownTokens": 926,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "54432c65c5e9906ea1f3ba9b6d8d486d6917aa2ba2d14ea34c4512184b70ff8d"
+      "digest": "1ecb7b1600a78a0f364b4d7f772a51011d9288bb7d8991b94e15fd2d4cb19dc0"
     },
     {
       "id": "guide.example-note",
@@ -17735,8 +18328,8 @@
         "indexUrl": "/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt"
       },
       "indexable": true,
-      "updated": "2026-11-05",
-      "contentDigest": "b1df50dcc3bad7c403deea15d1ce74e195eb12aff9f228df34d6fd4d00bcfbe8",
+      "updated": "2026-11-06",
+      "contentDigest": "ce141a2c3efdfe0e17dd9b51816cebe53fc33317bdf805f0f350f1c08cb72e35",
       "breadcrumbs": [
         {
           "label": "Reference",
@@ -17778,8 +18371,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/adapt-this-example.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "fd64cb0636a6b90ca82022f18b56521984ac68cff6a21f10ad1a9e2d5cc5773b",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "a7dd921f65b276b58d3fc719c236404a9703ecb743b1ff05dc311f4e943e74f5",
           "markdownBytes": 1456,
           "markdownTokens": 340,
           "markdownTokenEncoding": "cl100k_base"
@@ -17790,8 +18383,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/example-audience-and-scope.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "0f4aac0e250bd5a607458804f51345e000aa50d0c331acf90e858be9be3fc590",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "267b1140dadbd3dc324395745479f677fe0cfc2174bb1d2b1c68eead627a848d",
           "markdownBytes": 1373,
           "markdownTokens": 321,
           "markdownTokenEncoding": "cl100k_base"
@@ -17802,10 +18395,22 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/page-purpose-and-structure.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "9204b1e1e6df4ec696d243a43412d09b3b7353fc30e8436ca744a6c9576d06f5",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "8e2c3584f28ddbc6161df89b4086d2349e89c0bc21c7deaabed74b106f64b6c1",
           "markdownBytes": 5745,
-          "markdownTokens": 1029,
+          "markdownTokens": 1025,
+          "markdownTokenEncoding": "cl100k_base"
+        },
+        {
+          "id": "release-notes",
+          "title": "Release notes",
+          "depth": 2,
+          "markdownUrl": "/author/writing-style.sections/release-notes.md",
+          "parentMarkdownUrl": "/author/writing-style.md",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "9b637ec8a99b8082a825e24ca970c1625499247bd8035b45c78f5049a7ea5d45",
+          "markdownBytes": 1768,
+          "markdownTokens": 386,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -17814,8 +18419,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/voice-and-explanations.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "abaf440efdcd33ac239bf51aa7e131680178ff98dd18e16597aced5d15063614",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "ecbba187cadae66ca9098db2b405934df09ad006bab52b07f6063b2f093d7cd9",
           "markdownBytes": 3715,
           "markdownTokens": 673,
           "markdownTokenEncoding": "cl100k_base"
@@ -17826,8 +18431,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/procedures-and-examples.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "c5faa9f466893c187df73f07314794870e3bb45e65b30ec6cec417a2a8d1a015",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "aa701070b6f04d94fd14d29aff9e8f834857befdac32f5401268ac072023cfcf",
           "markdownBytes": 1910,
           "markdownTokens": 413,
           "markdownTokenEncoding": "cl100k_base"
@@ -17838,8 +18443,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/ingredients-recipes-and-cookbooks.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "cab4f2a387c4be90ee71965ae50721fa958aac8efe1866bd09c5e76d367925da",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "8c70b800e64b2a1eda5f05ef58a6af8001be91f51a00a3b96f11eebe4371bf30",
           "markdownBytes": 3222,
           "markdownTokens": 680,
           "markdownTokenEncoding": "cl100k_base"
@@ -17850,10 +18455,10 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/choose-components-by-reader-need.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "e893c161b7b34d8a83413720201894ac61c2226619ca203d93afbd16bfba6bff",
-          "markdownBytes": 3923,
-          "markdownTokens": 699,
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "af861031518eedb8518858f96ed3ce65b205c292a6a048ea6edde2097fe1c339",
+          "markdownBytes": 3931,
+          "markdownTokens": 700,
           "markdownTokenEncoding": "cl100k_base"
         },
         {
@@ -17862,8 +18467,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/feature-availability.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "7aa219f23744f5467e2234ea1276fdd42006e67edc82f15047cf9a1e51a301a9",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "4550435baca2408170f025bb34ba35503458bf090a64aa2f465c9359b3809936",
           "markdownBytes": 2861,
           "markdownTokens": 627,
           "markdownTokenEncoding": "cl100k_base"
@@ -17874,8 +18479,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/evidence-and-uncertainty.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "bf6ec290febafac851b08697d8f0c6793e2dfd9ae6af121c68b2f792239bfad9",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "7246776b54fd36ba2feed3b49081f0d35d649eb2065fb7537abeecd07de813c6",
           "markdownBytes": 1904,
           "markdownTokens": 417,
           "markdownTokenEncoding": "cl100k_base"
@@ -17886,8 +18491,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/reviewed-writing-examples.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "125fe417c8f3a240f22db687d84dbabb1a6c76ea33b9955ff1220d3ed7fcb13f",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "6e99de4b979360e2e7ffcb4ab1a131a142f3c9be22cd41a136c60d1c2fa33c2e",
           "markdownBytes": 3585,
           "markdownTokens": 637,
           "markdownTokenEncoding": "cl100k_base"
@@ -17898,8 +18503,8 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/review-a-draft.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "d30bf78772b77196a26c51e9243a48c3db9e8d1a430bc8b0947013aedfc19231",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "b08643bd39e390b1359c643e9fa163604ff07fcd2140991b5cfeaa7ac265c5a7",
           "markdownBytes": 1674,
           "markdownTokens": 373,
           "markdownTokenEncoding": "cl100k_base"
@@ -17910,17 +18515,17 @@
           "depth": 2,
           "markdownUrl": "/author/writing-style.sections/related-reading.md",
           "parentMarkdownUrl": "/author/writing-style.md",
-          "parentDigest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446",
-          "digest": "0142368ceeaec7c41225559f9d0e074f9dfac996b15a2b8eba49dd30cee31a11",
+          "parentDigest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26",
+          "digest": "f02eb11ea5fa5c0916541367e708cb8d12bf487c324f0d85cfad13b46a79f8e7",
           "markdownBytes": 1401,
           "markdownTokens": 338,
           "markdownTokenEncoding": "cl100k_base"
         }
       ],
-      "markdownBytes": 20707,
-      "markdownTokens": 3595,
+      "markdownBytes": 21392,
+      "markdownTokens": 3711,
       "markdownTokenEncoding": "cl100k_base",
-      "digest": "d9ffaafc00841b4fe4979364e1d175417bc9be76b9ada17440a7ca5e18f39446"
+      "digest": "f29c45d29a5308dea27e8e501f894358416780309e69b6353bfa1980cc995d26"
     },
     {
       "id": "reference.notes.getNote",
@@ -19434,6 +20039,54 @@
         "language": "en"
       }
     },
+    {
+      "id": "code-api-guide-openapi",
+      "from": "guide.code-api-references",
+      "to": "guide.api-references",
+      "type": "reference",
+      "reason": "Generate HTTP endpoint references when an OpenAPI contract describes the interface.",
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      }
+    },
+    {
+      "id": "code-api-guide-settings",
+      "from": "guide.code-api-references",
+      "to": "reference.code-api-references",
+      "type": "reference",
+      "reason": "Check catalog settings, snapshot fields, and converter limits.",
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      }
+    },
+    {
+      "id": "code-api-release-guide",
+      "from": "change.code-api-references",
+      "to": "guide.code-api-references",
+      "type": "next-step",
+      "reason": "Generate a reference from Python source or a converter snapshot.",
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      }
+    },
+    {
+      "id": "code-api-settings-guide",
+      "from": "reference.code-api-references",
+      "to": "guide.code-api-references",
+      "type": "next-step",
+      "reason": "Extract a Python snapshot and preview both grouped and complete SDK references.",
+      "variant": {
+        "channel": "production",
+        "version": "current",
+        "language": "en"
+      }
+    },
     {
       "id": "code-blocks-and-walkthrough",
       "from": "guide.component.code-blocks",
@@ -22354,7 +23007,7 @@
       "from": "change.navigation-layouts",
       "to": "guide.status",
       "type": "see-also",
-      "reason": "Check the alpha's capabilities and current limits.",
+      "reason": "Check the current capabilities and limits.",
       "order": 40,
       "variant": {
         "channel": "production",