From 44ad970e48580e169ee3d93fe346eb6b907d999d Mon Sep 17 00:00:00 2001 From: Vincent Koc Date: Fri, 24 Apr 2026 22:25:03 -0700 Subject: [PATCH] docs: replace generic 'this page covers' intros with direct openings Four pages started with weak meta-descriptions ('This page covers...') that restate the frontmatter summary. Replace with direct content-first openings, and sentence-case a stray 'Slash Commands' link in configuration-reference. --- docs/concepts/model-providers.md | 3 +-- docs/gateway/configuration-reference.md | 4 ++-- docs/reference/prompt-caching.md | 2 +- docs/tools/acp-agents-setup.md | 4 ++-- 4 files changed, 6 insertions(+), 7 deletions(-) diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md index b879b4e7a4d..bf0bebb55d9 100644 --- a/docs/concepts/model-providers.md +++ b/docs/concepts/model-providers.md @@ -6,8 +6,7 @@ read_when: title: "Model providers" --- -This page covers **LLM/model providers** (not chat channels like WhatsApp/Telegram). -For model selection rules, see [Models](/concepts/models). +Reference for **LLM/model providers** (not chat channels like WhatsApp/Telegram). For model selection rules, see [Models](/concepts/models). ## Quick rules diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md index b47885db151..f3cf6d92f31 100644 --- a/docs/gateway/configuration-reference.md +++ b/docs/gateway/configuration-reference.md @@ -8,7 +8,7 @@ read_when: Core config reference for `~/.openclaw/openclaw.json`. For a task-oriented overview, see [Configuration](/gateway/configuration). -This page covers the main OpenClaw config surfaces and links out when a subsystem has its own deeper reference. It does **not** try to inline every channel/plugin-owned command catalog or every deep memory/QMD knob on one page. +Covers the main OpenClaw config surfaces and links out when a subsystem has its own deeper reference. Channel- and plugin-owned command catalogs and deep memory/QMD knobs live on their own pages rather than on this one. Code truth: @@ -19,7 +19,7 @@ Code truth: Dedicated deep references: - [Memory configuration reference](/reference/memory-config) for `agents.defaults.memorySearch.*`, `memory.qmd.*`, `memory.citations`, and dreaming config under `plugins.entries.memory-core.config.dreaming` -- [Slash Commands](/tools/slash-commands) for the current built-in + bundled command catalog +- [Slash commands](/tools/slash-commands) for the current built-in + bundled command catalog - owning channel/plugin pages for channel-specific command surfaces Config format is **JSON5** (comments + trailing commas allowed). All fields are optional — OpenClaw uses safe defaults when omitted. diff --git a/docs/reference/prompt-caching.md b/docs/reference/prompt-caching.md index cac3b1789d8..3c5fa801106 100644 --- a/docs/reference/prompt-caching.md +++ b/docs/reference/prompt-caching.md @@ -16,7 +16,7 @@ cache values still take precedence over transcript fallback values. Why this matters: lower token cost, faster responses, and more predictable performance for long-running sessions. Without caching, repeated prompts pay the full prompt cost on every turn even when most input did not change. -This page covers all cache-related knobs that affect prompt reuse and token cost. +The sections below cover every cache-related knob that affects prompt reuse and token cost. Provider references: diff --git a/docs/tools/acp-agents-setup.md b/docs/tools/acp-agents-setup.md index 592be83264b..fed83c9c85f 100644 --- a/docs/tools/acp-agents-setup.md +++ b/docs/tools/acp-agents-setup.md @@ -8,8 +8,8 @@ title: "ACP agents — setup" --- For the overview, operator runbook, and concepts, see [ACP agents](/tools/acp-agents). -This page covers acpx harness config, plugin setup for the MCP bridges, and -permission configuration. + +The sections below cover acpx harness config, plugin setup for the MCP bridges, and permission configuration. ## acpx harness support (current)