fix: various changes

Author: jshackell-sfdc

src/markdown/command.ts

@@ -35,6 +35,7 @@ export class MarkdownCommand extends MarkdownBase {
   private state: unknown;
   private deprecated: boolean;
   private deprecationDetails: { version?: string; to?: string } | null;
+  private aliases: string[];
 
   public constructor(
     topic: string,
@@ -90,6 +91,7 @@ export class MarkdownCommand extends MarkdownBase {
     this.deprecated = (command.deprecated as boolean) ?? this.state === 'deprecated' ?? false;
     const dep = command.deprecated;
     this.deprecationDetails = dep && typeof dep === 'object' ? (dep as { version?: string; to?: string }) : null;
+    this.aliases = command.aliases ?? [];
   }
 
   protected async generate(): Promise<string> {
@@ -116,7 +118,7 @@ export class MarkdownCommand extends MarkdownBase {
     }
 
     if (this.help.length > 0) {
-      lines.push(`## Description for ${this.commandName}`);
+      lines.push(`## Description for "${this.commandName}"`);
       lines.push('');
       for (const paragraph of convertHyphenListsToMarkdown(
         this.help.map((p) => applyCodeFormatting(escapeAngleBrackets(p)))
@@ -126,6 +128,15 @@ export class MarkdownCommand extends MarkdownBase {
       }
     }
 
+    if (this.aliases.length > 0) {
+      lines.push(`## Aliases for "${this.commandName}"`);
+      lines.push('');
+      for (const alias of this.aliases) {
+        lines.push(`\`${alias}\``);
+        lines.push('');
+      }
+    }
+
     if (parameters.length > 0) {
       lines.push('## Flags');
       lines.push('');
@@ -141,7 +152,7 @@ export class MarkdownCommand extends MarkdownBase {
     }
 
     if (this.examples.length > 0) {
-      lines.push(`## Examples for ${this.commandName}`);
+      lines.push(`## Examples for "${this.commandName}"`);
       lines.push('');
       for (const example of this.examples) {
         if (example.description) {

src/utils.ts

@@ -21,7 +21,7 @@ import { AnyJson } from '@salesforce/ts-types';
 
 export type CommandClass = Pick<
   Command.Class,
-  'id' | 'hidden' | 'description' | 'plugin' | 'state' | 'examples' | 'summary' | 'flags' | 'pluginName'
+  'id' | 'hidden' | 'description' | 'plugin' | 'state' | 'examples' | 'summary' | 'flags' | 'pluginName' | 'aliases'
 > & { topic: string; subtopic: string; longDescription?: string; binary: string; deprecated?: boolean };
 
 export const events = new EventEmitter();