diff --git a/src/System.CommandLine/Option.cs b/src/System.CommandLine/Option.cs
index bac26af4a2..66ac89bdd3 100644
--- a/src/System.CommandLine/Option.cs
+++ b/src/System.CommandLine/Option.cs
@@ -41,12 +41,22 @@ protected Option(string name, string[] aliases) : base(name)
public bool HasDefaultValue => Argument.HasDefaultValue;
///
- /// Gets or sets the name of the Option when displayed in help.
+ /// Gets or sets the placeholder name shown in usage help for the option's value.
+ /// The value will be wrapped in angle brackets (< and >).
///
+ ///
+ /// If null, the of the option will be used,
+ /// with leading dashes and slashes removed.
+ ///
+ ///
+ /// An option with of --option and a
+ /// of Value will be shown in usage help as:
+ /// --option <Value>. If is not set,
+ /// help output will show: --option <option>.
+ ///
///
- /// The name of the option when displayed in help.
+ /// The name to show as the placeholder for the option's value.
///
- /// Useful for localization, as it's not used for actual parsing.
public string? HelpName
{
get => Argument.HelpName;