← Back to issue list

Present long/short options separated in the options table for markdown formatted help

View original Github issue

Metadata

Project
craft-cli
Number
#114
Type
issue
State
open
Author
facundobatista
Labels
—
Created
Updated
Closed
—

Current evaluation

Markdown help tables still combine short and long flags in one option cell; the maintainer’s requested separate short/long columns remains unimplemented.

Suggested action: keep open

Reason: The maintainer provided an explicit example of the desired three-column Markdown table. Current craft_cli/helptexts.py still emits a two-column table and combines titles such as `-h, --help`, while tests explicitly assert the old output, confirming the request is valid, narrowly scoped, and unresolved.

Evaluated by: mr-cal-bot

Impact: 28 Quick Win: 19 Complexity: 24 Confidence: 94 Actionability: 88

Issue body

IOW, we should have ``` | -v | --verbose | put stuff in verbose | | | --verbosity | set verbosity level | ``` instead of ``` | -v, --verbose | put stuff in verbose | | --verbosity | set verbosity level | ```

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 28
Quick Win: 19
Complexity: 24
Confidence: 94
Actionability: 88
keep open Markdown help tables still combine short and long flags in one option cell; the maintainer’s requested separate short/long columns remains unimplemented.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 19
Complexity: 20
Confidence: 70
Actionability: 80
keep open Feature request to split short/long options into separate columns in markdown help output tables
qwen/qwen3.8-27b
Impact: 15
Quick Win: 11
Staleness: 80
Complexity: 25
Confidence: 80
Support Request: 0
needs triage Request to render short and long CLI options in separate columns of the markdown help options table (e.g. | -v | --verbose | desc |) instead of combined '-v, --verbose'. Unlabelled, zero comments, and the current code still uses the combined format.
qwen/qwen3.6-35b-a3b
Staleness: 85
Complexity: 25
Confidence: 75
Support Request: 10
needs triage Formatting suggestion to display long and short CLI options in separate columns for markdown help output. Unlabelled, zero comments, inactive for over a year.
qwen3.6-35b-a3b-mtp-q6
Staleness: 88
Complexity: 10
Confidence: 70
Support Request: 5
needs triage Feature request to separate short and long CLI options into distinct columns in markdown help tables. Unaddressed for over three years with no maintainer comments or labels.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.