-
Notifications
You must be signed in to change notification settings - Fork 125
Description
Summary
PR #663 (17a85da — "docs(hve-guide): add role-based guides and project lifecycle documentation") removed CLI installation content from README.md during a documentation reorganization. The intent was to consolidate installation guidance into docs/getting-started/install.md, but CLI Plugins were never integrated into that page. The result is a two-part failure:
- Removed from README.md — The Quick Start section previously contained ~96 lines covering CLI Plugin Installation (
copilot plugin marketplace add,copilot plugin install), Automated Agent Installation, Manual Installation (links to all 8 methods), Prerequisites, and an RPI walkthrough. These were replaced with ~38 lines pointing to install.md. - Never added to install.md —
docs/getting-started/install.mdlists 7 installation methods across four navigation surfaces (Decision Matrix, Method Summary tables, ASCII Decision Tree, method links) but CLI Plugins is absent from all four.
docs/getting-started/methods/cli-plugins.md exists and is fully intact (sidebar_position: 2) but is orphaned — unreachable from both the README and the installation guide.
Expected behavior
install.md should include CLI Plugins as an installation method in all navigation surfaces, consistent with the other 7 methods. README.md line 46 already promises CLI plugin coverage via a link to install.md.
Current behavior
- CLI Plugins does not appear in the Decision Matrix table
- CLI Plugins does not appear in the Quick Decision Tree
- CLI Plugins does not appear in any of the three method summary tables (Simplest, Consumer, Developer)
cli-plugins.mdis orphaned — no page links to it
Steps to reproduce
- Open
docs/getting-started/install.md - Search for "CLI" or "plugin" — zero matches
- Navigate from README.md "Installation Guide" link — CLI plugins not discoverable
Root cause
PR #663 reorganized documentation but the receiving page (install.md) was never updated to include the CLI Plugins method that had been removed from README.md.