Skip to content

[command-reference]: add diff script, CI check, and update reference docs#1571

Open
saehejkang wants to merge 1 commit into
apple:mainfrom
saehejkang:docs/command-reference-bulk-updates
Open

[command-reference]: add diff script, CI check, and update reference docs#1571
saehejkang wants to merge 1 commit into
apple:mainfrom
saehejkang:docs/command-reference-bulk-updates

Conversation

@saehejkang
Copy link
Copy Markdown
Contributor

@saehejkang saehejkang commented May 17, 2026

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update

Motivation and Context

Relates to #1534

Thought it would be worthwhile to add a sort of mandatory check to the CI to fail, if the command-reference docs are not updated appropriately, whenever changes are made to the CLI. When the lint command is ran, there is an output that shows the diff between the current CLI build and what is written in the docs. Hopefully this will help keep the docs up to date and reduce tech debt over time.

NOTE: The scripts/generate-command-reference.py file was generated with AI but reviewed by me.

Testing

  • Tested locally
  • Added/updated tests
  • Added/updated docs

@jglogan jglogan self-requested a review May 18, 2026 17:16
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.

2 participants