Update docs for chromium deprecation in v1.9

Reflect changes from quarto-dev/quarto-cli#14335 (v1.9 backport):
chromium is deprecated, chrome-headless-shell is the recommended
tool, and arm64 Linux is now supported.

- Upgrade diagrams.qmd Legacy Chromium callout from note to warning,
  add migration steps and note future removal
- Update sample quarto check and quarto list tools output across
  bug-reports, troubleshooting, and pdf-engine pages to v1.9.37
- Fix malformed path line in troubleshooting quarto check sample
- Regenerate CLI reference includes from v1.9.37 cli-info.json
- Add path-scoped CLAUDE.md for auto-generated CLI includes
- Exclude CLAUDE.md from preview workflow changed-files detection

Author: cderv

.claude/rules/quarto-web-workflow.md

@@ -0,0 +1,10 @@
+# quarto-web Workflow
+
+## Stable → Prerelease
+
+1. PRs target `main` (stable/released docs)
+2. On merge, `port-to-prerelease.yml` (korthout/backport-action) auto-creates a cherry-pick PR to `prerelease`
+3. Prerelease-specific changes (e.g., v1.10 features) are layered in a follow-up PR after the backport merges
+
+Always PR to `main` first for shared content. Never PR directly to `prerelease` for changes that apply to both stable and prerelease.
+

.github/workflows/preview.yml

@@ -155,6 +155,8 @@ jobs:
             docs/reference/**/*.json
             docs/cli/*.json
             docs/**/images/*.png
+          files_ignore: |
+            **/CLAUDE.md
           json: true
           escape_json: false
 

bug-reports.qmd

@@ -100,44 +100,45 @@ For instance, the markdown code you would provide might look like this:
 
 ````md
 ```bash
-Quarto 1.5.42
+Quarto 1.9.37
 [✓] Checking versions of quarto binary dependencies...
-      Pandoc version 3.2.0: OK
+      Pandoc version 3.4.0: OK
       Dart Sass version 1.70.0: OK
-      Deno version 1.41.0: OK
+      Deno version 1.46.3: OK
       Typst version 0.11.0: OK
 [✓] Checking versions of quarto dependencies......OK
 [✓] Checking Quarto installation......OK
-      Version: 1.5.42
+      Version: 1.9.37
       Path: /Applications/quarto/bin
 
 [✓] Checking tools....................OK
-      TinyTeX: v2024.03.13
+      TinyTeX: v2026.04
       Chromium: (not installed)
+      Chrome Headless Shell: (not installed)
 
 [✓] Checking LaTeX....................OK
       Using: TinyTex
       Path: /Users/username/Library/TinyTeX/bin/universal-darwin
-      Version: 2024
+      Version: 2026
 
 [✓] Checking basic markdown render....OK
 
 [✓] Checking Python 3 installation....OK
       Version: 3.12.1
       Path: /.venv/bin/python3
       Jupyter: 5.7.2
-      Kernels: julia-1.10, python3
+      Kernels: python3
 
 [✓] Checking Jupyter engine render....OK
 
 [✓] Checking R installation...........OK
-      Version: 4.3.3
-      Path: /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources
+      Version: 4.4.2
+      Path: /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources
       LibPaths:
-        - /Users/username/Library/R/arm64/4.3/library
-        - /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources/library
-      knitr: 1.45
-      rmarkdown: 2.26
+        - /Users/username/Library/R/arm64/4.4/library
+        - /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library
+      knitr: 1.49
+      rmarkdown: 2.29
 
 [✓] Checking Knitr engine render......OK
 ```

docs/authoring/diagrams.qmd

@@ -246,8 +246,15 @@ quarto install chrome-headless-shell
 
 [Chrome Headless Shell](https://developer.chrome.com/blog/chrome-headless-shell) is a lightweight, headless-only browser from Google's [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing) infrastructure. It has fewer system dependencies than full Chromium, making it a good fit for Docker containers and WSL environments.
 
-::: callout-note
-## Legacy Chromium
+::: callout-warning
+## Chromium (Deprecated)
+
+The `quarto install chromium` command is deprecated as of Quarto 1.9 and will be removed in a future release. It still works but displays a deprecation warning. To migrate to Chrome Headless Shell, run:
+
+``` {.bash filename="Terminal"}
+quarto uninstall chromium
+quarto install chrome-headless-shell
+```
 
-The older `quarto install chromium` command (which installs Chromium via Puppeteer) is still available but no longer recommended. If you use it, note that the Puppeteer-bundled Chromium may not work in Docker or WSL — see [Puppeteer troubleshooting](https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md#running-puppeteer-in-docker) for details.
+The Puppeteer-bundled Chromium installed by the old command may not work in Docker or WSL — see [Puppeteer troubleshooting](https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md#running-puppeteer-in-docker) for details. Chrome Headless Shell does not have these limitations and also supports arm64 Linux.
 :::

docs/cli/cli-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.9.36",
+  "version": "1.9.37",
   "commands": [
     {
       "name": "render",
@@ -361,7 +361,7 @@
     {
       "name": "preview",
       "hidden": false,
-      "description": "Render and preview a document or website project.\n\nAutomatically reloads the browser when input files or document resources (e.g. CSS) change.\n\nFor website preview, the most recent execution results of computational documents are used to render\nthe site (this is to optimize startup time). If you want to perform a full render prior to\npreviewing pass the --render option with \"all\" or a comma-separated list of formats to render.\n\nFor document preview, input file changes will result in a re-render (pass --no-watch to prevent).\n\nYou can also include arbitrary command line arguments to be forwarded to \u001b[1mquarto render\u001b[22m.",
+      "description": "Render and preview a document or website project.\n\nAutomatically reloads the browser when input files or document resources (e.g. CSS) change.\n\nFor website preview, the most recent execution results of computational documents are used to render\nthe site (this is to optimize startup time). If you want to perform a full render prior to\npreviewing pass the --render option with \"all\" or a comma-separated list of formats to render.\n\nFor document preview, input file changes will result in a re-render (pass --no-watch to prevent).\n\nYou can also include arbitrary command line arguments to be forwarded to quarto render.",
       "options": [
         {
           "standalone": true,

docs/cli/includes/CLAUDE.md

@@ -0,0 +1,10 @@
+# CLI Reference: Auto-Generated Files
+
+Files in this directory are auto-generated. Do not edit manually.
+
+## Regeneration
+
+1. `quarto dev-call cli-info > docs/cli/cli-info.json`
+2. `Rscript --vanilla _tools/reference-cli-generate-md.R`
+
+Descriptions come from quarto-cli source. To change them permanently, update the CLI command definitions in quarto-cli.

docs/output-formats/pdf-engine.qmd

@@ -44,9 +44,11 @@ which will provide a list of available tools, the installed versions, and the la
 ``` bash
 [✓] Inspecting tools
 
-Tool         Status            Installed     Latest
-chromium     Not installed     ---           869685
-tinytex      Up to date        v2022.10      v2022.10
+Tool                      Status            Installed     Latest
+chrome-headless-shell     Not installed     ---           147.0.7727.56
+chromium                  Not installed     ---           869685
+tinytex                   Up to date        v2026.04      v2026.04
+verapdf                   Not installed     ---           1.28.2
 ```
 
 To update to the latest version, use the command:

docs/projects/binder.qmd

@@ -116,7 +116,7 @@ The following files may be generated by the `quarto use binder` command. Note th
 
 `postBuild`
 
-:   The post build script runs code after restoring the environment. This script is generated with commands required to ensure the proper version of Quarto is present in the environment, install any required tools like TinyTex or Chromium, and to configure VSCode and the Quarto extension for VSCode when applicable.
+:   The post build script runs code after restoring the environment. This script is generated with commands required to ensure the proper version of Quarto is present in the environment, install any required tools like TinyTeX or Chrome Headless Shell, and to configure VSCode and the Quarto extension for VSCode when applicable.
 
 `apt.txt`
 

docs/troubleshooting/index.qmd

@@ -13,46 +13,45 @@ but this page might help you get up and running quickly.
 You can check the version of Quarto and its dependencies by running `quarto check`. Here's an example of the output it generates:
 
 ```
-Quarto 1.6.30
-[✓] Checking environment information...
-      Quarto cache location: /Users/cscheid/Library/Caches/quarto
+Quarto 1.9.37
 [✓] Checking versions of quarto binary dependencies...
       Pandoc version 3.4.0: OK
       Dart Sass version 1.70.0: OK
       Deno version 1.46.3: OK
       Typst version 0.11.0: OK
 [✓] Checking versions of quarto dependencies......OK
 [✓] Checking Quarto installation......OK
-      Version: 1.6.30
-      Path: /Users/cscheid/repos/github/cscheid/quarto-regress/releases/v1.6.30/binQuarto 1.5.42
+      Version: 1.9.37
+      Path: /Applications/quarto/bin
 
 [✓] Checking tools....................OK
-      TinyTeX: v2024.03.13
+      TinyTeX: v2026.04
       Chromium: (not installed)
+      Chrome Headless Shell: (not installed)
 
 [✓] Checking LaTeX....................OK
       Using: TinyTex
       Path: /Users/username/Library/TinyTeX/bin/universal-darwin
-      Version: 2024
+      Version: 2026
 
 [✓] Checking basic markdown render....OK
 
 [✓] Checking Python 3 installation....OK
       Version: 3.12.1
       Path: /.venv/bin/python3
       Jupyter: 5.7.2
-      Kernels: julia-1.10, python3
+      Kernels: python3
 
 [✓] Checking Jupyter engine render....OK
 
 [✓] Checking R installation...........OK
-      Version: 4.3.3
-      Path: /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources
+      Version: 4.4.2
+      Path: /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources
       LibPaths:
-        - /Users/username/Library/R/arm64/4.3/library
-        - /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources/library
-      knitr: 1.45
-      rmarkdown: 2.26
+        - /Users/username/Library/R/arm64/4.4/library
+        - /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library
+      knitr: 1.49
+      rmarkdown: 2.29
 
 [✓] Checking Knitr engine render......OK
 ```