Skip to content

Add interactive command graph to docs#395

Open
Markus Herdieckerhoff (markusherdi) wants to merge 4 commits into
mainfrom
docs/add-command-graph
Open

Add interactive command graph to docs#395
Markus Herdieckerhoff (markusherdi) wants to merge 4 commits into
mainfrom
docs/add-command-graph

Conversation

@markusherdi

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

Copy link
Copy Markdown

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

@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 c19efbd. Configure here.

Comment thread docs/command-graph.html
@sonarqubecloud

sonarqubecloud Bot commented Jul 9, 2026

Copy link
Copy Markdown

an interactive visualization of every Content CLI command and its options. This file is a static, hand-maintained
snapshot — it is **not** generated automatically from the CLI source.

Whenever you add, remove, rename, deprecate, or change the options/description of a command, update

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

While I think the graph is very useful I'm not too keen on required manual updates whenever we change something (which is pretty much every PR). Since you generated it, can it be genereated? It takes a ridiculous amount of discipline to make sure such a thing doesn't drift.

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