diff --git a/src/resources/editor/tools/vs-code.mjs b/src/resources/editor/tools/vs-code.mjs
index 79af6837fe4..b3c507bc17d 100644
--- a/src/resources/editor/tools/vs-code.mjs
+++ b/src/resources/editor/tools/vs-code.mjs
@@ -7046,7 +7046,7 @@ var require_yaml_intelligence_resources = __commonJS({
           schema: {
             arrayOf: "string"
           },
-          description: "Array of rendering names"
+          description: "Array of rendering names, e.g. `[light, dark]`"
         },
         {
           name: "tags",
@@ -16879,8 +16879,8 @@ var require_yaml_intelligence_resources = __commonJS({
             ]
           },
           description: {
-            short: "Whether the `prefers-color-scheme` media query controls dark mode.",
-            long: "Whether to use the `prefers-color-scheme` media query to determine whether to show\nthe user a dark or light page. Otherwise the author preference (order of `light`\nand `dark` in `theme` or `brand`) determines what is shown to the user at first visit.\n"
+            short: "Enables setting dark mode based on the `prefers-color-scheme` media query.",
+            long: "If set, Quarto reads the `prefers-color-scheme` media query to determine whether to show\nthe user a dark or light page. Otherwise the author-preferred color scheme is shown.\n"
           }
         },
         {
@@ -22964,6 +22964,10 @@ var require_yaml_intelligence_resources = __commonJS({
         "Enables hover over a section title to see an anchor link.",
         "Enables tabsets to present content.",
         "Enables smooth scrolling within the page.",
+        {
+          short: "Whether the <code>prefers-color-scheme</code> media query controls\ndark mode.",
+          long: "Whether to use the <code>prefers-color-scheme</code> media query to\ndetermine whether to show the user a dark or light page. Otherwise the\nauthor preference (order of <code>light</code> and <code>dark</code> in\n<code>theme</code> or <code>brand</code>) determines what is shown to\nthe user at first visit."
+        },
         {
           short: "Method use to render math in HTML output",
           long: 'Method use to render math in HTML output (<code>plain</code>,\n<code>webtex</code>, <code>gladtex</code>, <code>mathml</code>,\n<code>mathjax</code>, <code>katex</code>).\nSee the Pandoc documentation on <a href="https://pandoc.org/MANUAL.html#math-rendering-in-html">Math\nRendering in HTML</a> for additional details.'
@@ -24057,11 +24061,7 @@ var require_yaml_intelligence_resources = __commonJS({
         "Disambiguating year suffix in author-date styles (e.g.&nbsp;\u201Ca\u201D in \u201CDoe,\n1999a\u201D).",
         "Manuscript configuration",
         "internal-schema-hack",
-        "List execution engines you want to give priority when determining\nwhich engine should render a notebook. If two engines have support for a\nnotebook, the one listed earlier will be chosen. Quarto\u2019s default order\nis \u2018knitr\u2019, \u2018jupyter\u2019, \u2018markdown\u2019, \u2018julia\u2019.",
-        {
-          short: "Whether the <code>prefers-color-scheme</code> media query controls\ndark mode.",
-          long: "Whether to use the <code>prefers-color-scheme</code> media query to\ndetermine whether to show the user a dark or light page. Otherwise the\nauthor preference (order of <code>light</code> and <code>dark</code> in\n<code>theme</code> or <code>brand</code>) determines what is shown to\nthe user at first visit."
-        }
+        "List execution engines you want to give priority when determining\nwhich engine should render a notebook. If two engines have support for a\nnotebook, the one listed earlier will be chosen. Quarto\u2019s default order\nis \u2018knitr\u2019, \u2018jupyter\u2019, \u2018markdown\u2019, \u2018julia\u2019."
       ],
       "schema/external-schemas.yml": [
         {
@@ -24290,12 +24290,12 @@ var require_yaml_intelligence_resources = __commonJS({
         mermaid: "%%"
       },
       "handlers/mermaid/schema.yml": {
-        _internalId: 194479,
+        _internalId: 194627,
         type: "object",
         description: "be an object",
         properties: {
           "mermaid-format": {
-            _internalId: 194471,
+            _internalId: 194619,
             type: "enum",
             enum: [
               "png",
@@ -24311,7 +24311,7 @@ var require_yaml_intelligence_resources = __commonJS({
             exhaustiveCompletions: true
           },
           theme: {
-            _internalId: 194478,
+            _internalId: 194626,
             type: "anyOf",
             anyOf: [
               {
diff --git a/src/resources/editor/tools/yaml/web-worker.js b/src/resources/editor/tools/yaml/web-worker.js
index cf935b89c4c..7510ed74d45 100644
--- a/src/resources/editor/tools/yaml/web-worker.js
+++ b/src/resources/editor/tools/yaml/web-worker.js
@@ -7047,7 +7047,7 @@ try {
             schema: {
               arrayOf: "string"
             },
-            description: "Array of rendering names"
+            description: "Array of rendering names, e.g. `[light, dark]`"
           },
           {
             name: "tags",
@@ -16880,8 +16880,8 @@ try {
               ]
             },
             description: {
-              short: "Whether the `prefers-color-scheme` media query controls dark mode.",
-              long: "Whether to use the `prefers-color-scheme` media query to determine whether to show\nthe user a dark or light page. Otherwise the author preference (order of `light`\nand `dark` in `theme` or `brand`) determines what is shown to the user at first visit.\n"
+              short: "Enables setting dark mode based on the `prefers-color-scheme` media query.",
+              long: "If set, Quarto reads the `prefers-color-scheme` media query to determine whether to show\nthe user a dark or light page. Otherwise the author-preferred color scheme is shown.\n"
             }
           },
           {
@@ -22965,6 +22965,10 @@ try {
           "Enables hover over a section title to see an anchor link.",
           "Enables tabsets to present content.",
           "Enables smooth scrolling within the page.",
+          {
+            short: "Whether the <code>prefers-color-scheme</code> media query controls\ndark mode.",
+            long: "Whether to use the <code>prefers-color-scheme</code> media query to\ndetermine whether to show the user a dark or light page. Otherwise the\nauthor preference (order of <code>light</code> and <code>dark</code> in\n<code>theme</code> or <code>brand</code>) determines what is shown to\nthe user at first visit."
+          },
           {
             short: "Method use to render math in HTML output",
             long: 'Method use to render math in HTML output (<code>plain</code>,\n<code>webtex</code>, <code>gladtex</code>, <code>mathml</code>,\n<code>mathjax</code>, <code>katex</code>).\nSee the Pandoc documentation on <a href="https://pandoc.org/MANUAL.html#math-rendering-in-html">Math\nRendering in HTML</a> for additional details.'
@@ -24058,11 +24062,7 @@ try {
           "Disambiguating year suffix in author-date styles (e.g.&nbsp;\u201Ca\u201D in \u201CDoe,\n1999a\u201D).",
           "Manuscript configuration",
           "internal-schema-hack",
-          "List execution engines you want to give priority when determining\nwhich engine should render a notebook. If two engines have support for a\nnotebook, the one listed earlier will be chosen. Quarto\u2019s default order\nis \u2018knitr\u2019, \u2018jupyter\u2019, \u2018markdown\u2019, \u2018julia\u2019.",
-          {
-            short: "Whether the <code>prefers-color-scheme</code> media query controls\ndark mode.",
-            long: "Whether to use the <code>prefers-color-scheme</code> media query to\ndetermine whether to show the user a dark or light page. Otherwise the\nauthor preference (order of <code>light</code> and <code>dark</code> in\n<code>theme</code> or <code>brand</code>) determines what is shown to\nthe user at first visit."
-          }
+          "List execution engines you want to give priority when determining\nwhich engine should render a notebook. If two engines have support for a\nnotebook, the one listed earlier will be chosen. Quarto\u2019s default order\nis \u2018knitr\u2019, \u2018jupyter\u2019, \u2018markdown\u2019, \u2018julia\u2019."
         ],
         "schema/external-schemas.yml": [
           {
@@ -24291,12 +24291,12 @@ try {
           mermaid: "%%"
         },
         "handlers/mermaid/schema.yml": {
-          _internalId: 194479,
+          _internalId: 194627,
           type: "object",
           description: "be an object",
           properties: {
             "mermaid-format": {
-              _internalId: 194471,
+              _internalId: 194619,
               type: "enum",
               enum: [
                 "png",
@@ -24312,7 +24312,7 @@ try {
               exhaustiveCompletions: true
             },
             theme: {
-              _internalId: 194478,
+              _internalId: 194626,
               type: "anyOf",
               anyOf: [
                 {
diff --git a/src/resources/editor/tools/yaml/yaml-intelligence-resources.json b/src/resources/editor/tools/yaml/yaml-intelligence-resources.json
index b205f1dd522..b34c9c91945 100644
--- a/src/resources/editor/tools/yaml/yaml-intelligence-resources.json
+++ b/src/resources/editor/tools/yaml/yaml-intelligence-resources.json
@@ -18,7 +18,7 @@
       "schema": {
         "arrayOf": "string"
       },
-      "description": "Array of rendering names"
+      "description": "Array of rendering names, e.g. `[light, dark]`"
     },
     {
       "name": "tags",
@@ -9851,8 +9851,8 @@
         ]
       },
       "description": {
-        "short": "Whether the `prefers-color-scheme` media query controls dark mode.",
-        "long": "Whether to use the `prefers-color-scheme` media query to determine whether to show\nthe user a dark or light page. Otherwise the author preference (order of `light`\nand `dark` in `theme` or `brand`) determines what is shown to the user at first visit.\n"
+        "short": "Enables setting dark mode based on the `prefers-color-scheme` media query.",
+        "long": "If set, Quarto reads the `prefers-color-scheme` media query to determine whether to show\nthe user a dark or light page. Otherwise the author-preferred color scheme is shown.\n"
       }
     },
     {
@@ -15936,6 +15936,10 @@
     "Enables hover over a section title to see an anchor link.",
     "Enables tabsets to present content.",
     "Enables smooth scrolling within the page.",
+    {
+      "short": "Whether the <code>prefers-color-scheme</code> media query controls\ndark mode.",
+      "long": "Whether to use the <code>prefers-color-scheme</code> media query to\ndetermine whether to show the user a dark or light page. Otherwise the\nauthor preference (order of <code>light</code> and <code>dark</code> in\n<code>theme</code> or <code>brand</code>) determines what is shown to\nthe user at first visit."
+    },
     {
       "short": "Method use to render math in HTML output",
       "long": "Method use to render math in HTML output (<code>plain</code>,\n<code>webtex</code>, <code>gladtex</code>, <code>mathml</code>,\n<code>mathjax</code>, <code>katex</code>).\nSee the Pandoc documentation on <a href=\"https://pandoc.org/MANUAL.html#math-rendering-in-html\">Math\nRendering in HTML</a> for additional details."
@@ -17029,11 +17033,7 @@
     "Disambiguating year suffix in author-date styles (e.g.&nbsp;“a” in “Doe,\n1999a”).",
     "Manuscript configuration",
     "internal-schema-hack",
-    "List execution engines you want to give priority when determining\nwhich engine should render a notebook. If two engines have support for a\nnotebook, the one listed earlier will be chosen. Quarto’s default order\nis ‘knitr’, ‘jupyter’, ‘markdown’, ‘julia’.",
-    {
-      "short": "Whether the <code>prefers-color-scheme</code> media query controls\ndark mode.",
-      "long": "Whether to use the <code>prefers-color-scheme</code> media query to\ndetermine whether to show the user a dark or light page. Otherwise the\nauthor preference (order of <code>light</code> and <code>dark</code> in\n<code>theme</code> or <code>brand</code>) determines what is shown to\nthe user at first visit."
-    }
+    "List execution engines you want to give priority when determining\nwhich engine should render a notebook. If two engines have support for a\nnotebook, the one listed earlier will be chosen. Quarto’s default order\nis ‘knitr’, ‘jupyter’, ‘markdown’, ‘julia’."
   ],
   "schema/external-schemas.yml": [
     {
@@ -17262,12 +17262,12 @@
     "mermaid": "%%"
   },
   "handlers/mermaid/schema.yml": {
-    "_internalId": 194479,
+    "_internalId": 194627,
     "type": "object",
     "description": "be an object",
     "properties": {
       "mermaid-format": {
-        "_internalId": 194471,
+        "_internalId": 194619,
         "type": "enum",
         "enum": [
           "png",
@@ -17283,7 +17283,7 @@
         "exhaustiveCompletions": true
       },
       "theme": {
-        "_internalId": 194478,
+        "_internalId": 194626,
         "type": "anyOf",
         "anyOf": [
           {
diff --git a/src/resources/schema/cell-attributes.yml b/src/resources/schema/cell-attributes.yml
index 6d89b637342..970375fbec6 100644
--- a/src/resources/schema/cell-attributes.yml
+++ b/src/resources/schema/cell-attributes.yml
@@ -13,7 +13,7 @@
 - name: renderings
   schema:
     arrayOf: string
-  description: "Array of rendering names"
+  description: "Array of rendering names, e.g. `[light, dark]`"
 
 - name: tags
   tags:
diff --git a/src/resources/schema/document-options.yml b/src/resources/schema/document-options.yml
index b309c9f293c..5170a8ac705 100644
--- a/src/resources/schema/document-options.yml
+++ b/src/resources/schema/document-options.yml
@@ -90,11 +90,10 @@
   tags:
     formats: [$html-doc]
   description:
-    short: "Whether the `prefers-color-scheme` media query controls dark mode."
+    short: "Enables setting dark mode based on the `prefers-color-scheme` media query."
     long: |
-      Whether to use the `prefers-color-scheme` media query to determine whether to show
-      the user a dark or light page. Otherwise the author preference (order of `light`
-      and `dark` in `theme` or `brand`) determines what is shown to the user at first visit.
+      If set, Quarto reads the `prefers-color-scheme` media query to determine whether to show
+      the user a dark or light page. Otherwise the author-preferred color scheme is shown.
 
 - name: html-math-method
   tags: