diff --git a/docs/guides/container-base-image.md b/docs/guides/container-base-image.md
index 95157393..13773aed 100644
--- a/docs/guides/container-base-image.md
+++ b/docs/guides/container-base-image.md
@@ -101,13 +101,19 @@ which `agent-assembly` SDK release gets baked in.
 | *unset* (default) | Installs the **latest stable** SDK release; if no stable release exists yet, the **latest pre-release**. |
 | set to a version | Installs **exactly** that version — e.g. `SDK_VERSION=0.0.1b5`. |
 
-```bash
-# Default — let the image resolve the newest appropriate SDK release:
-docker build -t my-agent .
+=== "Default"
 
-# Pin an exact SDK version for a fully reproducible build:
-docker build --build-arg SDK_VERSION=0.0.1b5 -t my-agent .
-```
+    ```bash
+    # Let the image resolve the newest appropriate SDK release:
+    docker build -t my-agent .
+    ```
+
+=== "Pinned version"
+
+    ```bash
+    # Pin an exact SDK version for a fully reproducible build:
+    docker build --build-arg SDK_VERSION=0.0.1b5 -t my-agent .
+    ```
 
 !!! tip "Published images already pin the SDK"
     The images published to GHCR are built with `SDK_VERSION` pinned to a specific SDK
diff --git a/docs/stylesheets/aaasm-brand.css b/docs/stylesheets/aaasm-brand.css
index faa2923c..3776eb37 100644
--- a/docs/stylesheets/aaasm-brand.css
+++ b/docs/stylesheets/aaasm-brand.css
@@ -45,3 +45,13 @@
     overflow-x: auto;
   }
 }
+
+/* AAASM-4560: content-tab titles (pymdownx.tabbed, alternate_style) default to the
+   full body size, which reads as heavy for short labels like "pip"/"uv"/"Default".
+   Render them a step smaller and tighter than body text so the tab strip stays a
+   quiet control, not a heading. Scoped to the tab labels only — tab *content* keeps
+   body sizing. */
+.md-typeset .tabbed-set > .tabbed-labels > label {
+  font-size: 0.68rem;
+  letter-spacing: -0.005em;
+}
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 7f5ccfb5..194ff924 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -50,10 +50,17 @@ still works.
 
 To enable it:
 
-```bash
-pip install --pre 'agent-assembly[runtime]'   # bundled platform wheel, or
-uv tool run maturin develop --manifest-path native/aa-ffi-python/Cargo.toml --release  # build locally (needs Rust)
-```
+=== "pip"
+
+    ```bash
+    pip install --pre 'agent-assembly[runtime]'   # bundled platform wheel
+    ```
+
+=== "uv"
+
+    ```bash
+    uv tool run maturin develop --manifest-path native/aa-ffi-python/Cargo.toml --release  # build locally (needs Rust)
+    ```
 
 ## Still stuck?