feat: add aliases and examples

Author: amphro

src/ditamap/base-ditamap.ts

@@ -11,7 +11,7 @@ export class BaseDitamap extends Ditamap {
   constructor(topics: string[]) {
     // Set the data of topic and filenames
     super('cli_reference.ditamap', {
-      namespaceDitamapFiles: topics.map(topic => `${topic}/cli_reference_${topic}.ditamap`)
+      namespaceDitamapFiles: topics.sort().map(topic => `${topic}/cli_reference_${topic}.ditamap`)
     });
   }
 

src/ditamap/subtopic-ditamap.ts

@@ -11,6 +11,9 @@ import { Ditamap } from './ditamap';
 export class SubTopicDitamap extends Ditamap {
   constructor(topic: string, subtopic: string, commandFileNames: string[]) {
     const filename = `cli_reference_${topic}_${subtopic}.ditamap`;
+
+    commandFileNames.sort();
+
     // Set the data of topic and filenames
     super(filename, {
       topic,

templates/command.hbs

@@ -98,5 +98,21 @@ IF YOU WANT TO CHANGE THIS CONTENT, CONTACT juliet.shackell@salesforce.com FOR D
             {{/each}}
         </section>
         {{/if}}
+        {{#if aliases}}
+        <section>
+            <title><ph>Aliases for <codeph otherprops="nolang">{{id}}</codeph></ph></title>
+            {{#each aliases}}
+                <codeblock otherprops="nolang">{{this}}</codeblock>
+            {{/each}}
+        </section>
+        {{/if}}
+        {{#if examples}}
+        <section>
+            <title><ph>Examples for <codeph otherprops="nolang">{{id}}</codeph></ph></title>
+            {{#each examples}}
+            {{#isCodeBlock this}}<codeblock otherprops="nolang">{{this}}</codeblock>{{else}}<p>{{this}}</p>{{/isCodeBlock}}
+            {{/each}}
+        </section>
+        {{/if}}
     </refbody>
 </reference>