openclaw/docs/help
Vincent Koc e8ffd3cf09
docs: replace private paths and document the ClawHub docs source (#140227)
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).
2026-09-06 23:48:33 +08:00
..
debugging.md perf(plugins): reuse compiled checkout artifacts for cold Doctor (#136399) 2026-09-02 13:48:40 -07:00
environment.md fix(shell-env): preserve CLI terminal ownership during login imports (#139308) 2026-09-06 08:30:11 +05:30
faq-first-run.md fix: preserve channel answers after unavailable approvals (#130624) 2026-08-27 01:50:36 -07:00
faq-models.md fix(models): keep ordinary chat selections session-scoped (#139232) 2026-09-05 23:09:32 +05:30
faq.md docs: replace private paths and document the ClawHub docs source (#140227) 2026-09-06 23:48:33 +08:00
index.md docs: retire redundant guides and fix gateway package instructions (#133722) 2026-08-30 21:10:43 -07:00
scripts.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
testing-live.md fix(live): repair model E2E selection and session fixtures (#131229) 2026-08-27 20:09:39 -07:00
testing-updates-plugins.md fix(postinstall): preserve other installs' runtime dependencies (#134099) 2026-09-04 00:54:49 -07:00
testing.md perf(build): avoid unrelated gateway artifact scans (#127757) 2026-09-05 16:43:24 -07:00
troubleshooting.md fix(cli): automations runs required --id while sibling commands took a positional id (#138438) 2026-09-05 08:19:37 +08:00