From 4432588c78c50358552d9733cc022eb83b4d5cb8 Mon Sep 17 00:00:00 2001
From: Zanie Blue <contact@zanie.dev>
Date: Thu, 12 Feb 2026 16:16:51 -0600
Subject: [PATCH] Use trixie instead of bookworm in the docs (#17991)

Co-authored-by: Claude <noreply@anthropic.com>
---
 docs/guides/integration/gitlab.md                |  2 +-
 docs/reference/troubleshooting/build-failures.md | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/guides/integration/gitlab.md b/docs/guides/integration/gitlab.md
index 5944205c1..7a2029af6 100644
--- a/docs/guides/integration/gitlab.md
+++ b/docs/guides/integration/gitlab.md
@@ -15,7 +15,7 @@ Select a variant that is suitable for your workflow.
 variables:
   UV_VERSION: "0.10.2"
   PYTHON_VERSION: "3.12"
-  BASE_LAYER: bookworm-slim
+  BASE_LAYER: trixie-slim
   # GitLab CI creates a separate mountpoint for the build directory,
   # so we need to copy instead of using hard links.
   UV_LINK_MODE: copy
diff --git a/docs/reference/troubleshooting/build-failures.md b/docs/reference/troubleshooting/build-failures.md
index e83475606..23a3dba25 100644
--- a/docs/reference/troubleshooting/build-failures.md
+++ b/docs/reference/troubleshooting/build-failures.md
@@ -116,7 +116,7 @@ The following examples demonstrate common build failures and how to resolve them
 
 If the build error mentions a missing command, for example, `gcc`:
 
-<!-- docker run --platform linux/x86_64 -it ghcr.io/astral-sh/uv:python3.10-bookworm-slim /bin/bash -c "uv pip install --system pysha3==1.0.2" -->
+<!-- docker run --platform linux/x86_64 -it ghcr.io/astral-sh/uv:python3.10-trixie-slim /bin/bash -c "uv pip install --system pysha3==1.0.2" -->
 
 ```hl_lines="17"
 × Failed to build `pysha3==1.0.2`
@@ -164,7 +164,7 @@ install it with your system package manager.
 
 For example, installing `pygraphviz` requires Graphviz to be installed:
 
-<!-- docker run --platform linux/x86_64 -it ghcr.io/astral-sh/uv:python3.12-bookworm /bin/bash -c "uv pip install --system 'pygraphviz'" -->
+<!-- docker run --platform linux/x86_64 -it ghcr.io/astral-sh/uv:python3.12-trixie /bin/bash -c "uv pip install --system 'pygraphviz'" -->
 
 ```hl_lines="18-19"
 × Failed to build `pygraphviz==1.14`
@@ -205,7 +205,7 @@ installed.
 
 !!! tip
 
-    To resolve an error where `Python.h` is missing, install the [`python3-dev` package](https://packages.debian.org/bookworm/python3-dev).
+    To resolve an error where `Python.h` is missing, install the [`python3-dev` package](https://packages.debian.org/trixie/python3-dev).
 
 ### Module is missing or cannot be imported
 
@@ -215,7 +215,7 @@ If the build error mentions a failing import, consider
 For example, some packages assume that `pip` is available without declaring it as a build
 dependency:
 
-<!-- docker run --platform linux/x86_64 -it ghcr.io/astral-sh/uv:python3.12-bookworm-slim /bin/bash -c "uv pip install --system chumpy" -->
+<!-- docker run --platform linux/x86_64 -it ghcr.io/astral-sh/uv:python3.12-trixie-slim /bin/bash -c "uv pip install --system chumpy" -->
 
 ```hl_lines="7"
   × Failed to build `chumpy==0.70`
@@ -271,7 +271,7 @@ dill<0.3.9,>=0.2.2
 apache-beam<=2.49.0
 ```
 
-<!-- docker run --platform linux/x86_64 -it ghcr.io/astral-sh/uv:python3.10-bookworm-slim /bin/bash -c "printf 'dill<0.3.9,>=0.2.2\napache-beam<=2.49.0' | uv pip compile -" -->
+<!-- docker run --platform linux/x86_64 -it ghcr.io/astral-sh/uv:python3.10-trixie-slim /bin/bash -c "printf 'dill<0.3.9,>=0.2.2\napache-beam<=2.49.0' | uv pip compile -" -->
 
 ```hl_lines="1"
 × Failed to build `apache-beam==2.0.0`