#22632: docs: fix redirects and small reorg
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
#17770: refactor(cli): reuse shared option builders
by iyoda · 2026-02-16
81.0%
#10894: Docs: fix legacy branding, add config reference, expand cron troubl...
by biv0711 · 2026-02-07
78.8%
#16362: Update session-pruning.md - updated agents.defaults config std
by elliottb · 2026-02-14
78.4%
#23669: refactor(logging): migrate node-host and tailscale console calls to...
by kevinWangSheng · 2026-02-22
77.1%
#11048: fix: address repository issues (env, author, CI comments, security ...
by cavula · 2026-02-07
76.8%
#7252: docs: align config examples and tool docs with current runtime
by nice-and-precise · 2026-02-02
76.6%
#16251: docs: remove note about personal single-user access from trusted pr...
by nickytonline · 2026-02-14
76.5%
#23798: docs: add Docker pairing cross-reference to Control UI page
by dglewis · 2026-02-22
76.1%
#16124: Docs: rewrite Coolify guide for native one-click service
by frankdierolf · 2026-02-14
76.0%
#23757: docs: replace outdated legacy names and paths
by jainilDesai · 2026-02-22
75.9%