← Back to PRs

#22632: docs: fix redirects and small reorg

by gianpaj open 2026-02-21 12:37 View on GitHub →
docs gateway size: XS
## Summary Describe the problem and fix in 2–5 bullets: - Problem: CLI reference docs lived under `docs/cli`, making reference navigation inconsistent with other reference material. - Why it matters: CLI reference pages should live under `docs/reference` for consistency and maintainability. - What changed: Moved CLI docs to `docs/reference/cli`, updated English nav + links, and added redirects from `/cli/*` to `/reference/cli/*`. - What did NOT change (scope boundary): No content edits to the CLI docs themselves beyond path/links; no updates to generated `docs/zh-CN/**`. ## Change Type (select all) - [ ] Bug fix - [ ] Feature - [ ] Refactor - [x] Docs - [ ] Security hardening - [ ] Chore/infra ## Scope (select all touched areas) - [ ] Gateway / orchestration - [ ] Skills / tool execution - [ ] Auth / tokens - [ ] Memory / storage - [ ] Integrations - [ ] API / contracts - [x] UI / DX - [ ] CI/CD / infra ## Linked Issue/PR - Closes: none - Related: none ## User-visible / Behavior Changes - CLI docs now live under `/reference/cli/*`; old `/cli/*` paths redirect. ## Security Impact (required) - New permissions/capabilities? (No) - Secrets/tokens handling changed? (No) - New/changed network calls? (No) - Command/tool execution surface changed? (No) - Data access scope changed? (No) ~- If any `Yes`, explain risk + mitigation:~ ## Human Verification (required) What you personally verified (not just CI), and how: - Verified scenarios: `pnpm run docs` works - Edge cases checked: `node scripts/docs-link-audit.mjs` works - What you did **not** verify: ## Compatibility / Migration - Backward compatible? (Yes) - Config/env changes? (No) - Migration needed? (No) - If yes, exact upgrade steps: ## Failure Recovery (if this breaks) - How to disable/revert this change quickly: - Files/config to restore: - Known bad symptoms reviewers should watch for: ## Risks and Mitigations List only real risks for this PR. Add/remove entries as needed. If none, write `None`. - Risk: Low - Mitigation: revert commit <!-- greptile_comment --> <h3>Greptile Summary</h3> Moved CLI reference docs from `docs/cli` to `docs/reference/cli` for better organization and consistency with other reference material. **Key changes:** - Relocated 36 CLI command docs to `docs/reference/cli/` directory - Added comprehensive redirects from `/cli/*` to `/reference/cli/*` in `docs.json` - Updated all internal links in English docs to point to new paths - Preserved 5 CLI docs in original location (`acp`, `config`, `devices`, `node`, `webhooks`) - Updated navigation structure to reflect new paths **Scope boundaries respected:** - Chinese docs (`docs/zh-CN/**`) intentionally not updated per PR description - No content changes to CLI docs beyond path/link updates - All redirects properly configured for backward compatibility <h3>Confidence Score: 5/5</h3> - This PR is safe to merge with minimal risk - it's a well-executed documentation refactoring - Score reflects thorough execution: all 36 CLI docs properly moved, comprehensive redirects configured, internal links correctly updated in English docs, and explicit scope boundaries (zh-CN not updated) clearly communicated. The changes are purely organizational with proper backward compatibility through redirects. - No files require special attention - all changes follow a consistent pattern <sub>Last reviewed commit: e785f7d</sub> <!-- greptile_other_comments_section --> <!-- /greptile_comment -->

Most Similar PRs