Skip to content

[winml] [P2] Subcommand descriptions in winml --help are truncated mid-word #511

Description

@zhenchaoni

Severity: P2
Command: winml


Category: Unicode/Output Rendering — table column widths must respect terminal width without hiding meaning.

Repro:

uv run winml --help

Actual (from the captured 80-column run):

Commands:
  analyze       Analyze ONNX model for runtime support with live progress.
  build         Build a WinML-optimized ONNX model from a HuggingFace model
  compile       Compile ONNX model to EP-specific format.
  config        Generate WinMLBuildConfig for a HuggingFace model or .onnx f
  eval          Evaluate model accuracy on a dataset.
  expand_rules  Expand runtime rules zip files in-place when directories and
  export        Export HuggingFace model to ONNX format with HTP.
  hub           Browse ModelKit's curated built-in model catalog.

config is cut off at .onnx f (intended: …or .onnx file). expand_rules is cut off at directories and (intended: …directories and zips coexist). build ends at from a HuggingFace model with no period.

Expected: Either trim each first-line description so it fits in 80 cols without , or wrap to the next line with continued indent (Click supports both). No mid-word truncation.

Why it matters: The first-line subcommand summary is the single most-read line of help. Truncation here gives users a wrong or incomplete idea of what each subcommand does and undermines the rest of the documentation.

Metadata

Metadata

Labels

P2Medium — minor bug or non-critical improvementbugSomething isn't workingdev experienceDeveloper experience improvementsqualityUse for quality control related issuestriagedIssue has been triaged

Type

Fields

No fields configured for Bug.

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions