From 82fd83418e22c44af82c4abd59a7cab9127dc509 Mon Sep 17 00:00:00 2001 From: Vincent Koc Date: Tue, 5 May 2026 16:33:00 -0700 Subject: [PATCH] docs: replace ampersand headings for stable Mintlify anchors Per docs/CLAUDE.md, Mintlify anchor generation is brittle for headings that contain em dashes, apostrophes, and ampersands. Normalize 9 H2 headings across docs/date-time.md, docs/pi.md, docs/platforms/{index, macos, mac/webchat, mac/peekaboo}.md, docs/nodes/{images,audio}.md, and docs/reference/AGENTS.default.md from `X & Y` to `X and Y` so anchors do not collapse on entity decoding. Verified no inbound anchor references to the renamed sections in the docs tree. --- docs/date-time.md | 2 +- docs/nodes/audio.md | 2 +- docs/nodes/images.md | 2 +- docs/pi.md | 4 ++-- docs/platforms/index.md | 2 +- docs/platforms/mac/peekaboo.md | 2 +- docs/platforms/mac/webchat.md | 2 +- docs/platforms/macos.md | 2 +- docs/reference/AGENTS.default.md | 2 +- 9 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/date-time.md b/docs/date-time.md index f3bf4efd11c..bd8a22c9e88 100644 --- a/docs/date-time.md +++ b/docs/date-time.md @@ -62,7 +62,7 @@ You can override this behavior: [WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up ``` -## System prompt: Current Date & Time +## System prompt: current date and time If the user timezone is known, the system prompt includes a dedicated **Current Date & Time** section with the **time zone only** (no clock/time format) diff --git a/docs/nodes/audio.md b/docs/nodes/audio.md index 28e852787de..912ccdce5d7 100644 --- a/docs/nodes/audio.md +++ b/docs/nodes/audio.md @@ -144,7 +144,7 @@ Note: Binary detection is best-effort across macOS/Linux/Windows; ensure the CLI } ``` -## Notes & limits +## Notes and limits - Provider auth follows the standard model auth order (auth profiles, env vars, `models.providers.*.apiKey`). - Groq setup details: [Groq](/providers/groq). diff --git a/docs/nodes/images.md b/docs/nodes/images.md index 49111305d7e..de52e791e90 100644 --- a/docs/nodes/images.md +++ b/docs/nodes/images.md @@ -51,7 +51,7 @@ The WhatsApp channel runs via **Baileys Web**. This document captures the curren - If the active primary image model already supports vision natively, OpenClaw skips the `[Image]` summary block and passes the original image to the model instead. - By default only the first matching image/audio/video attachment is processed; set `tools.media..attachments` to process multiple attachments. -## Limits & Errors +## Limits and errors **Outbound send caps (WhatsApp web send)** diff --git a/docs/pi.md b/docs/pi.md index 06e9767f7c6..3f3004a2820 100644 --- a/docs/pi.md +++ b/docs/pi.md @@ -337,7 +337,7 @@ const compactResult = await compactEmbeddedPiSessionDirect({ }); ``` -## Authentication & Model Resolution +## Authentication and model resolution ### Auth profiles @@ -418,7 +418,7 @@ if (cfg?.agents?.defaults?.contextPruning?.mode === "cache-ttl") { } ``` -## Streaming & Block Replies +## Streaming and block replies ### Block chunking diff --git a/docs/platforms/index.md b/docs/platforms/index.md index 063816214b0..95baae3beaf 100644 --- a/docs/platforms/index.md +++ b/docs/platforms/index.md @@ -22,7 +22,7 @@ Native companion apps for Windows are also planned; the Gateway is recommended v - Windows: [Windows](/platforms/windows) - Linux: [Linux](/platforms/linux) -## VPS & hosting +## VPS and hosting - VPS hub: [VPS hosting](/vps) - Fly.io: [Fly.io](/install/fly) diff --git a/docs/platforms/mac/peekaboo.md b/docs/platforms/mac/peekaboo.md index c156b3c1097..933b13c9118 100644 --- a/docs/platforms/mac/peekaboo.md +++ b/docs/platforms/mac/peekaboo.md @@ -65,7 +65,7 @@ socket path is in use. You can override with: export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock ``` -## Security & permissions +## Security and permissions - The bridge validates **caller code signatures**; an allowlist of TeamIDs is enforced (Peekaboo host TeamID + OpenClaw app TeamID). diff --git a/docs/platforms/mac/webchat.md b/docs/platforms/mac/webchat.md index cb0267d421d..8cf5e7bf9ee 100644 --- a/docs/platforms/mac/webchat.md +++ b/docs/platforms/mac/webchat.md @@ -13,7 +13,7 @@ agent (with a session switcher for other sessions). - **Remote mode**: forwards the Gateway control port over SSH and uses that tunnel as the data plane. -## Launch & debugging +## Launch and debugging - Manual: Lobster menu → “Open Chat”. - Auto‑open for testing: diff --git a/docs/platforms/macos.md b/docs/platforms/macos.md index 93e4a2359d3..f30d5cb3ecd 100644 --- a/docs/platforms/macos.md +++ b/docs/platforms/macos.md @@ -162,7 +162,7 @@ If `openclaw doctor` detects state under: it will warn and recommend moving back to a local path. -## Build & dev workflow (native) +## Build and dev workflow (native) - `cd apps/macos && swift build` - `swift run OpenClaw` (or Xcode) diff --git a/docs/reference/AGENTS.default.md b/docs/reference/AGENTS.default.md index 04eabaab0f2..8363a66c9a5 100644 --- a/docs/reference/AGENTS.default.md +++ b/docs/reference/AGENTS.default.md @@ -72,7 +72,7 @@ cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md - Capture: decisions, preferences, constraints, open loops. - Avoid secrets unless explicitly requested. -## Tools & skills +## Tools and skills - Tools live in skills; follow each skill’s `SKILL.md` when you need it. - Keep environment-specific notes in `TOOLS.md` (Notes for Skills).