mirror of
https://github.com/openclaw/openclaw.git
synced 2026-09-28 14:12:28 +08:00
Vincent Koc
e8ffd3cf09
Docs governance and publish-hygiene pass over docs/AGENTS.md and the pages its rules cover. - Replace every `~/Projects` operator path in docs/ with a neutral placeholder. 38 occurrences across 13 pages, including the private repo path `~/Projects/manager/skills`. `docs/AGENTS.md` forbids local paths, and its own Internal Docs bullet named one. - Record the placeholder convention in the Published Link Rules bullet that bans local paths. - Document the ClawHub docs source in Source Ownership: this repo holds no `/clawhub/**` page sources even though `docs/docs.json` lists them, so a local preview and `pnpm docs:check-links` report those routes as missing until `OPENCLAW_DOCS_SYNC_CLAWHUB_REPO` points at a ClawHub checkout. - Drop the Strict-STE hard violation rate on `docs/AGENTS.md` from 18 hard (3.4 per 100 words) to 0 by splitting semicolon sentences and sentences over 20 words, and by naming the actor in passive sentences. No rule changes meaning. - Convert the Maturity Scorecard paragraph to a bulleted list, matching every other section. - `docs/prose.md`: name v2026.8.1 as the release that removed OpenProse, and explain the `--agent codex` flag and the third-party skills CLI. - Link `/prose` from `tools/skills` and `tools/slash-commands`. - `docs/docs_map.md`: correct the summary to describe the stub, and drop the H1 that repeated the frontmatter title. Closes audit findings: r3-0734, r3-0736, r3-0907, r3-0910, r3-2277, r3-2278, r3-2285, r3-2286, r3-2287, r3-2288, r4-clawhub-0001 Partially addresses r3-0906 (private path removed; publish-tree exclusion left as a follow-up). Not addressed: r3-0909 (generator change).
341 B
341 B
summary, read_when, title
| summary | read_when | title |
|---|---|---|
| Source stub for the generated docs map | Finding which docs page covers a topic before reading the page | Docs map source |
The public and packaged docs map is generated from all docs headings during publishing and packaging. Run pnpm docs:list --headings to render the same map from a source checkout.