mirror of
https://github.com/openclaw/openclaw.git
synced 2026-10-05 05:06:37 +00:00
docs/help/testing.md was 79,946 characters and mixed how-to, reference, contributor conventions, and roadmap content in one page. It is now a short index over six pages, one per reader job: - help/testing/suites: quick start, the suite reference, which suite to run, the live-test pointer, docs sanity, and offline regressions. - help/testing/live-workflows: live provider debugging through the Docker and Parallels lanes. - help/testing/docker: the Docker "works in Linux" runners, their weighted scheduler, the lane catalog, and their env vars. - help/testing/qa-runners: the qa-lab command surface, the shared Convex credential contract, and adding a channel to QA. - help/testing/contracts: plugin and channel contract tests. - help/testing/writing-tests: temp-directory rules, the agent reliability eval gaps, and how to add a regression. Anchor strategy: per-anchor routes are impossible because redirectSource() rejects any source containing [?#]. Instead every one of the 49 ids the old page published stays alive on the index as an authored <a id="..." /> stub in "Where each section moved". Ids were computed with parseDocsDocument, not a slug approximation, so punctuated headings keep both emitted forms (for example docker-runners-(optional-%22works-in-linux%22-checks) and docker-runners-optional-works-in-linux-checks). The index still publishes `related` itself, so that id is deliberately not stubbed and no duplicate authored/canonical ID is raised. Losslessness, asserted mechanically rather than by eye: all 14 original section bodies are character-identical after the move (0 lost, 0 changed), and the page lede is byte-identical. Word count 9,632 -> 9,632, code fences 18 -> 18, links 13 -> 13, table rows 0 -> 0. All 751 inline code spans and fenced blocks compare as an identical set, so every command in the guide is unchanged. The only body delta is six trailing newlines removed by scripts/format-docs.mts. Verified independently of docs-link-audit, which a split makes uninformative because it rewrites the repo's own links: the 49 pre-split ids were enumerated from HEAD, the post-split index and every child were re-parsed, and each id was asserted to resolve. 0 unresolved, 0 stub targets that miss their child, 0 collisions. Prose findings are deliberately left alone and deferred: r3-0398, r3-0399, r3-0400, r3-0401, r3-1686, r3-1687, r3-1688, r3-1689, r3-1690. Closes audit findings: r3-0397 |
||
|---|---|---|
| .. | ||
| testing | ||
| debugging.md | ||
| environment.md | ||
| faq-first-run.md | ||
| faq-models.md | ||
| faq.md | ||
| index.md | ||
| scripts.md | ||
| testing-live.md | ||
| testing-updates-plugins.md | ||
| testing.md | ||
| troubleshooting.md | ||