Merge pull request #1061 from salesforcecli/jshackell-sfdc-patch-2

support dev preview commands

Author: jshackell-sfdc

src/ditamap/command.ts

@@ -119,6 +119,7 @@ export class Command extends Ditamap {
       examples,
       help,
       isBetaCommand: state === 'beta',
+      isPreviewCommand: state === 'preview',
       isClosedPilotCommand: state === 'closedPilot',
       isOpenPilotCommand: state === 'openPilot',
       trailblazerCommunityName,

src/utils.ts

@@ -113,6 +113,7 @@ export type CommandData = {
   isClosedPilotCommand: boolean;
   isOpenPilotCommand: boolean;
   isBetaCommand: boolean;
+  isPreviewCommand: boolean;
   deprecated: boolean;
   trailblazerCommunityUrl?: string;
   trailblazerCommunityName?: string;

templates/command.hbs

@@ -9,7 +9,7 @@ IF YOU WANT TO CHANGE THIS CONTENT, CONTACT juliet.shackell@salesforce.com FOR D
 
 -->
     {{!--Not all commands have a minor noun; some are just commandmajornoun:commandverb. This is a sample topic for a commmand with no minor noun.--}}
-    <title><codeph otherprops="nolang">{{name}}</codeph>{{#if isClosedPilotCommand}} (Pilot){{/if}}{{#if isOpenPilotCommand}} (Pilot){{/if}}{{#if isBetaCommand}} (Beta){{/if}}{{#if deprecated}} (Deprecated){{/if}}</title>
+    <title><codeph otherprops="nolang">{{name}}</codeph>{{#if isPreviewCommand}} (Developer Preview){{/if}}{{#if isClosedPilotCommand}} (Pilot){{/if}}{{#if isOpenPilotCommand}} (Pilot){{/if}}{{#if isBetaCommand}} (Beta){{/if}}{{#if deprecated}} (Deprecated){{/if}}</title>
     <shortdesc>
       <ph id="shortdesc">
         {{#if deprecated}}The command <codeph otherprops="nolang">{{name}}</codeph> has been deprecated{{#if deprecationOptions.version}} and will be removed in v{{deprecationOptions.version}} or later{{/if}}. {{#if deprecated.to}} Use <codeph otherprops="nolang">{{deprecated.to}}</codeph> instead. {{/if}} {{/if}}{{summary}}
@@ -48,6 +48,9 @@ IF YOU WANT TO CHANGE THIS CONTENT, CONTACT juliet.shackell@salesforce.com FOR D
         </section>{{/if}}{{#if isBetaCommand}}
         <section>
             <note>This feature is a Beta Service. Customers may opt to try such Beta Service in its sole discretion. Any use of the Beta Service is subject to the applicable Beta Services Terms provided at Agreements and Terms (<xref href="https://www.salesforce.com/company/legal/agreements/" format="html" scope="external" type="new-window:HTML">https://www.salesforce.com/company/legal/agreements/</xref>).</note>
+        </section>{{/if}}{{#if isPreviewCommand}}
+        <section>
+            <note>This command is available as a developer preview. The command isn’t generally available unless or until Salesforce announces its general availability in documentation or in press releases or public statements. All commands, parameters, and other features are subject to change or deprecation at any time, with or without notice. Don't implement functionality developed with these commands or tools.</note>
         </section>{{/if}}
         {{#if help}}
         <section>