fix: add summary field to org flags (#137)

* fix: add desc to sfdx org flags

* fix: do not deprecate `-v` short flag [skip-ci]

* fix: description -> summary [skip ci]

messages/messages.md

@@ -34,6 +34,14 @@ No default dev hub found. Use -v or --target-dev-hub to specify an environment.
 
 The specified org %s is not a Dev Hub.
 
+# flags.targetOrg.summary
+
+Username or alias of the target org.
+
+# flags.targetDevHubOrg.summary
+
+Username or alias of the Dev Hub org.
+
 # flags.apiVersion.description
 
 Override the api version used for api requests made by this command

src/compatibility.ts

@@ -71,6 +71,6 @@ export const requiredOrgFlagWithDeprecations = requiredOrgFlag({
  * @deprecated
  */
 export const requiredHubFlagWithDeprecations = requiredHubFlag({
-  aliases: ['targetdevhubusername', 'v'],
+  aliases: ['targetdevhubusername'],
   deprecateAliases: true,
 });

src/flags/orgFlags.ts

@@ -97,6 +97,7 @@ export const optionalOrgFlag = Flags.custom({
  */
 export const requiredOrgFlag = Flags.custom({
   char: 'o',
+  summary: messages.getMessage('flags.targetOrg.summary'),
   parse: async (input: string | undefined) => getOrgOrThrow(input),
   default: async () => getOrgOrThrow(),
   defaultHelp: async () => (await getOrgOrThrow())?.getUsername(),
@@ -126,6 +127,7 @@ export const requiredOrgFlag = Flags.custom({
  */
 export const requiredHubFlag = Flags.custom({
   char: 'v',
+  summary: messages.getMessage('flags.targetDevHubOrg.summary'),
   parse: async (input: string | undefined) => getHubOrThrow(input),
   default: async () => getHubOrThrow(),
   defaultHelp: async () => (await getHubOrThrow())?.getUsername(),