Edit/improve messages for the two commands

messages/display.md

@@ -1,12 +1,20 @@
+# summary
+
+Display information about limits in your org.
+
 # description
 
-display current org’s limits
-When you execute this command in a project, it provides limit information for your default scratch org.",
+For each limit, this command returns the maximum allocation and the remaining allocation based on usage. See this topic for a description of each limit: https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_limits.htm.
 
 # examples
 
-- <%= config.bin %> <%= command.id %>
-- <%= config.bin %> <%= command.id %> --target-org me@my.org
+- Display limits in your default org:
+
+  <%= config.bin %> <%= command.id %>
+
+- Display limits in the org with alias "my-scratch-org":
+
+  <%= config.bin %> <%= command.id %> --target-org my-scratch-org
 
 # targetOrg
 

messages/recordcounts.md

@@ -1,16 +1,28 @@
+# summary
+
+Display record counts for the specified standard or custom objects.
+
 # description
 
-display record counts for the specified standard and custom objects\nUse this command to get an approximate count of the records in standard or custom objects in your org. These record counts are the same as the counts listed in the Storage Usage page in Setup. The record counts are approximate because they're calculated asynchronously and your org's storage usage isn't updated immediately. To display all available record counts, run the command without the '--sobjecttype' parameter.",
+Use this command to get an approximate count of the records in standard or custom objects in your org. These record counts are the same as the counts listed in the Storage Usage page in the Setup UI. The record counts are approximate because they're calculated asynchronously and your org's storage usage isn't updated immediately. To display all available record counts, run the command without the --sobject flag.
 
 # examples
 
-- <%= config.bin %> <%= command.id %>
-- <%= config.bin %> <%= command.id %> --sobject Account --sobject Contact,Lead,Opportunity
-- <%= config.bin %> <%= command.id %> --sobject Account,Contact --target-org me@my.org
+- Display all available record counts in your default org:
+
+  <%= config.bin %> <%= command.id %>
+
+- Display record counts for the Account, Contact, Lead, and Opportunity objects in your default org:
+
+  <%= config.bin %> <%= command.id %> --sobject Account --sobject Contact --sobject Lead --sobject Opportunity
+
+- Display record counts for the Account and Lead objects for the org with alias "my-scratch-org":
+
+  <%= config.bin %> <%= command.id %> --sobject Account --sobject Lead --target-org my-scratch-org
 
 # sobjectFlagDescription
 
-comma-separated list of API names of standard or custom objects for which to display record counts
+API name of the standard or custom object for which to display record counts.
 
 # targetOrg
 

src/commands/limits/api/display.ts

@@ -32,7 +32,7 @@ export type ApiLimits = ApiLimit[];
 
 export class LimitsApiDisplayCommand extends SfCommand<ApiLimits> {
   public static aliases = ['force:limits:api:display', 'org:list:limits'];
-  public static readonly summary = messages.getMessage('description');
+  public static readonly summary = messages.getMessage('summary');
   public static readonly description = messages.getMessage('description');
   public static readonly examples = messages.getMessages('examples');
   public static flags = {

src/commands/limits/recordcounts/display.ts

@@ -29,7 +29,7 @@ interface Result {
 
 export class LimitsRecordCountsDisplayCommand extends SfCommand<RecordCounts> {
   public static readonly aliases = ['force:limits:recordcounts:display', 'org:list:sobject:record-counts'];
-  public static readonly summary = messages.getMessage('description');
+  public static readonly summary = messages.getMessage('summary');
   public static readonly description = messages.getMessage('description');
   public static readonly examples = messages.getMessages('examples');