Skip to content

Conversation

jeffhandley
Copy link
Member

Fixes #2594

We entertained renaming the member but did not arrive an a name improvement that justified making a breaking change at this stage. Instead of renaming, this PR augments and corrects the API docs (and therefore IntelliSense) to make the member's purpose clearer.

We intend to backport this fix into release/10.0.

@jeffhandley jeffhandley merged commit 18a0a54 into dotnet:main Sep 26, 2025
10 checks passed
@jeffhandley jeffhandley deleted the jeffhandley/helpname-api-docs branch September 26, 2025 19:37
Copy link
Member

@adamsitnik adamsitnik left a comment

Choose a reason for hiding this comment

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

It looks great, but could you please apply similar changes to Argument.HelpName as well?

/// <summary>
/// The name used in help output to describe the argument.
/// </summary>
public string? HelpName { get; set; }

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation for Option.HelpName inaccurate and mysterious
3 participants