Skip to content

CLI Plugins installation method missing from install.md navigation surfaces #900

@WilliamBerryiii

Description

@WilliamBerryiii

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:

  1. 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.
  2. Never added to install.mddocs/getting-started/install.md lists 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.md is orphaned — no page links to it

Steps to reproduce

  1. Open docs/getting-started/install.md
  2. Search for "CLI" or "plugin" — zero matches
  3. 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.

Metadata

Metadata

Labels

documentationImprovements or additions to documentation

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions