Skip to content

Make --help easier to navigate with topic-filtered views#2467

Open
soulgalore wants to merge 1 commit into
mainfrom
help-topics
Open

Make --help easier to navigate with topic-filtered views#2467
soulgalore wants to merge 1 commit into
mainfrom
help-topics

Conversation

@soulgalore
Copy link
Copy Markdown
Member

Browsertime --help dumps every option from all 13 topic groups in one
screen, which is overwhelming for new users and slow to skim. Adopt
the curl/ffmpeg pattern: show a small curated subset by default, let
users drill into one topic at a time, and keep the full reference one
flag away for scripts and power users.

browsertime --help now shows a short list of common options plus the
available topic names. browsertime --help shows just that
topic, and browsertime --help-all reproduces the historical full
dump for anyone relying on it.

Each option already carries an inline group: '' field, so the
dispatcher captures the topic-to-keys map by wrapping yargs's .option()
call -- no changes to the 1400-line option chain.

Co-authored-by: Claude noreply@anthropic.com

Change-Id: I5d79c91617c5c9a06497b8306deff854c83ec5e2

  Browsertime --help dumps every option from all 13 topic groups in one
  screen, which is overwhelming for new users and slow to skim. Adopt
  the curl/ffmpeg pattern: show a small curated subset by default, let
  users drill into one topic at a time, and keep the full reference one
  flag away for scripts and power users.

  browsertime --help now shows a short list of common options plus the
  available topic names. browsertime --help <topic> shows just that
  topic, and browsertime --help-all reproduces the historical full
  dump for anyone relying on it.

  Each option already carries an inline group: '<topic>' field, so the
  dispatcher captures the topic-to-keys map by wrapping yargs's .option()
  call -- no changes to the 1400-line option chain.

  Co-authored-by: Claude noreply@anthropic.com

Change-Id: I5d79c91617c5c9a06497b8306deff854c83ec5e2
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.

1 participant