Skip to content

Add interactive command graph to docs#395

Merged
Markus Herdieckerhoff (markusherdi) merged 6 commits into
mainfrom
docs/add-command-graph
Jul 14, 2026
Merged

Add interactive command graph to docs#395
Markus Herdieckerhoff (markusherdi) merged 6 commits into
mainfrom
docs/add-command-graph

Conversation

@markusherdi

@markusherdi Markus Herdieckerhoff (markusherdi) commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds docs/command-graph.html, an interactive, searchable visualization of every content-cli command (grouped by area, with descriptions/options shown on click).
  • Links to it from the README's new "Command Graph" section via raw.githack.com, so it renders live in the browser without needing to be downloaded.
  • Documents in docs/how-to-add-command.md that the graph must be updated manually whenever commands are added, removed, renamed, or changed.
  • Removes the stale Agentic Development link (docs/user-guide/agentic-development-guide.md) from mkdocs.yaml and docs/user-guide/index.md — the file was deleted in SP-880: remove asset-registry-endpoints agent skill #380 but the links were never cleaned up.

Test plan


Note

Low Risk
Documentation-only changes with no runtime or CLI behavior impact; the main follow-up risk is the graph drifting from the real command tree if contributors skip manual updates.

Overview
Adds docs/command-graph.html, a static, hand-maintained vis-network page that maps the full content-cli tree (search, sidebar details/options, deprecated styling) and documents the same surface area as the CLI help text.

The README gains a Command Graph section and TOC entry, linking the live view via raw.githack.com and pointing contributors to how-to-add-command.md for keeping NODES / EDGES in sync when commands change.

how-to-add-command.md now requires updating the graph in the same PR as command changes.

Removes the broken Agentic Development entry from mkdocs.yaml and docs/user-guide/index.md after the guide file was removed earlier.

Reviewed by Cursor Bugbot for commit 7e7b5d7. Bugbot is set up for automated code reviews on this repo. Configure here.

Comment thread docs/command-graph.html
Comment thread docs/how-to-add-command.md

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit df12b59. Configure here.

Comment thread docs/command-graph.html Outdated
@sonarqubecloud

Copy link
Copy Markdown

@markusherdi Markus Herdieckerhoff (markusherdi) merged commit 6c85671 into main Jul 14, 2026
6 checks passed
@markusherdi Markus Herdieckerhoff (markusherdi) deleted the docs/add-command-graph branch July 14, 2026 11:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants