finos · kriswest · May 30, 2023 · Mar 9, 2023 · Mar 9, 2023 · Mar 9, 2023
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -14,6 +14,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### Deprecated
 
+* Deprecated `IntentMetadata.displayName` and the appD record's `interop.intents.listensFor[].displayName` field in favour of using intent names for display (which are required to be recognizable) as it can be set differently for each application in the appD ([#926](https://github.com/finos/FDC3/pull/926))
+
 ### Fixed
 
 ## [FDC3 Standard 2.0](https://github.com/finos/FDC3/compare/v1.2..v2.0) - 2022-07-01

diff --git a/docs/api/ref/DesktopAgent.md b/docs/api/ref/DesktopAgent.md
@@ -283,7 +283,7 @@ I know 'StartChat' exists as a concept, and want to know which apps can resolve
 const appIntent = await fdc3.findIntent("StartChat");
 // returns a single AppIntent:
 // {
-//   intent: { name: "StartChat", displayName: "Chat" },
+//   intent: { name: "StartChat" },
 //   apps: [
 //    { appId: "Skype" }, 
 //    { appId: "Symphony" }, 
@@ -299,7 +299,7 @@ const appIntent = await fdc3.findIntent("StartChat");
 // returns an AppIntent, but with multiple options for resolution, 
 // which includes an existing instance of an application:
 // {
-//   intent: { name: "StartChat", displayName: "Chat" },
+//   intent: { name: "StartChat" },
 //   apps: [
 //    { appId: "Skype" }, 
 //    { appId: "Symphony" }, 
@@ -315,21 +315,21 @@ const appIntent = await fdc3.findIntent("StartChat", contact);
 
 // returns only apps that support the type of the specified input context:
 // {
-//     intent: { name: "StartChat", displayName: "Chat" },
+//     intent: { name: "StartChat" },
 //     apps: { name: "Symphony" }]
 // }
 
 const appIntent = await fdc3.findIntent("ViewContact", "fdc3.ContactList");
 // returns only apps that return the specified result type:
 // {
-//     intent: { name: "ViewContact", displayName: "View Contact Details" },
+//     intent: { name: "ViewContact" },
 //     apps: { appId: "MyCRM", resultType: "fdc3.ContactList"}]
 // }
 
 const appIntent = await fdc3.findIntent("QuoteStream", instrument, "channel<fdc3.Quote>");
 // returns only apps that return a channel which will receive the specified input and result types:
 // {
-//     intent: { name: "QuoteStream", displayName: "Quotes stream" },
+//     intent: { name: "QuoteStream" },
 //     apps: { appId: "MyOMS", resultType: "channel<fdc3.Quote>"}]
 // }
 ```
@@ -363,11 +363,11 @@ const appIntents = await fdc3.findIntentsByContext(context);
 // returns, for example:
 // [
 //   {
-//     intent: { name: "StartCall", displayName: "Call" },
+//     intent: { name: "StartCall" },
 //     apps: [{ appId: "Skype" }]
 //   },
 //   {
-//     intent: { name: "StartChat", displayName: "Chat" }, 
+//     intent: { name: "StartChat" }, 
 //     apps: [
 //       { appId: "Skype" }, 
 //       { appId: "Symphony" }, 
@@ -376,7 +376,7 @@ const appIntents = await fdc3.findIntentsByContext(context);
 //     ]
 //   },
 //   {
-//     intent: { name: "ViewContact", displayName: "View Contact" },
+//     intent: { name: "ViewContact" },
 //     apps: [{ appId: "Symphony" }, { appId: "MyCRM", resultType: "fdc3.ContactList"}]
 //   }
 // ];
@@ -388,7 +388,7 @@ or I look for only intents that are resolved by apps returning a particular resu
 const appIntentsForType = await fdc3.findIntentsByContext(context, "fdc3.ContactList");
 // returns for example:
 // [{
-//     intent: { name: "ViewContact", displayName: "View Contact" },
+//     intent: { name: "ViewContact" },
 //     apps: [{ appId: "Symphony" }, { appId: "MyCRM", resultType: "fdc3.ContactList"}]
 // }];
 

diff --git a/docs/api/ref/Metadata.md b/docs/api/ref/Metadata.md
@@ -302,8 +302,9 @@ interface IntentMetadata {
   /** The unique name of the intent that can be invoked by the raiseIntent call. */
   readonly name: string;
 
-  /** A friendly display name for the intent that should be used to render UI
-   *  elements.
+  /** Display name for the intent.
+   * @deprecated Use the intent name for display as display name may vary for
+   * each application as it is defined in the app's AppD record.
    */
   readonly displayName: string;
 }

diff --git a/src/api/DesktopAgent.ts b/src/api/DesktopAgent.ts
@@ -72,7 +72,7 @@ export interface DesktopAgent {
    *
    * // returns a single AppIntent:
    * // {
-   * //     intent: { name: "StartChat", displayName: "Chat" },
+   * //     intent: { name: "StartChat" },
    * //   apps: [
    * //    { appId: "Skype" },
    * //    { appId: "Symphony" },
@@ -88,7 +88,7 @@ export interface DesktopAgent {
    * // returns an AppIntent, but with multiple options for resolution,
    * // which includes an existing instance of an application:
    * // {
-   * //   intent: { name: "StartChat", displayName: "Chat" },
+   * //   intent: { name: "StartChat" },
    * //   apps: [
    * //    { appId: "Skype" },
    * //    { appId: "Symphony" },
@@ -104,23 +104,23 @@ export interface DesktopAgent {
    *
    * // returns only apps that support the type of the specified input context:
    * // {
-   * //     intent: { name: "StartChat", displayName: "Chat" },
+   * //     intent: { name: "StartChat" },
    * //     apps: [{ appId: "Symphony" }]
    * // }
    *
    * const appIntent = await fdc3.findIntent("ViewContact", contact, "fdc3.ContactList");
    *
    * // returns only apps that return the specified result Context type:
    * // {
-   * //     intent: { name: "ViewContact", displayName: "View Contact Details" },
+   * //     intent: { name: "ViewContact" },
    * //     apps: { appId: "MyCRM", resultType: "fdc3.ContactList"}]
    * // }
    *
    * const appIntent = await fdc3.findIntent("QuoteStream", instrument, "channel<fdc3.Quote>");
    *
    * // returns only apps that return a channel which will receive the specified input and result types:
    * // {
-   * //     intent: { name: "QuoteStream", displayName: "Quotes stream" },
+   * //     intent: { name: "QuoteStream" },
    * //     apps: [{ appId: "MyOMS", resultType: "channel<fdc3.Quote>"}]
    * // }
    * ```
@@ -148,11 +148,11 @@ export interface DesktopAgent {
    * // returns for example:
    * // [
    * //   {
-   * //     intent: { name: "StartCall", displayName: "Call" },
+   * //     intent: { name: "StartCall" },
    * //     apps: [{ name: "Skype" }]
    * //   },
    * //   {
-   * //     intent: { name: "StartChat", displayName: "Chat" },
+   * //     intent: { name: "StartChat" },
    * //     apps: [
    * //       { appId: "Skype" },
    * //       { appId: "Symphony" },
@@ -166,7 +166,7 @@ export interface DesktopAgent {
    * const appIntentsForType = await fdc3.findIntentsByContext(context, "fdc3.ContactList");
    * // returns for example:
    * // [{
-   * //     intent: { name: "ViewContact", displayName: "View Contacts" },
+   * //     intent: { name: "ViewContact" },
    * //     apps: [{ appId: "MyCRM", resultType: "fdc3.ContactList"}]
    * // }];
    *

diff --git a/src/api/IntentMetadata.ts b/src/api/IntentMetadata.ts
@@ -10,6 +10,9 @@ export interface IntentMetadata {
   /** The unique name of the intent that can be invoked by the raiseIntent call */
   readonly name: string;
 
-  /** A friendly display name for the intent that should be used to render UI elements */
+  /** Display name for the intent.
+   * @deprecated Use the intent name for display as display name may vary for
+   * each application as it is defined in the app's AppD record.
+   */
   readonly displayName: string;
 }
diff --git a/src/app-directory/specification/appd.yaml b/src/app-directory/specification/appd.yaml
@@ -607,7 +607,8 @@ components:
       properties:
         displayName:
           type: string
-          description: An optional display name for the intent that may be used in UI instead of the name.
+          description: Optional display name for the intent. Deprecated in favour of the intent name, which is common amongst all apps that support it, where the display name may vary as it is defined in the app's AppD record.
+          deprecated: true
         contexts:
           type: array
           items:
@@ -1028,11 +1029,9 @@ components:
           intents: 
             listensFor: 
               ViewChart: 
-                displayName: View Chart
                 contexts: 
                   - fdc3.instrument
               myApp.GetPrice: 
-                displayName: Get Price
                 contexts: 
                   - fdc3.instrument
                 resultType: myApp.quote
@@ -1143,11 +1142,9 @@ components:
               intents: 
                 listensFor: 
                   ViewChart: 
-                    displayName: View Chart
                     contexts: 
                       - fdc3.instrument
                   myApp.GetPrice: 
-                    displayName: Get Price
                     contexts: 
                       - fdc3.instrument
                     resultType: myApp.quote

diff --git a/website/static/schemas/next/app-directory.yaml b/website/static/schemas/next/app-directory.yaml
@@ -607,7 +607,8 @@ components:
       properties:
         displayName:
           type: string
-          description: An optional display name for the intent that may be used in UI instead of the name.
+          description: Optional display name for the intent. Deprecated in favour of the intent name, which is common amongst all apps that support it, where the display name may vary as it is defined in the app's AppD record.
+          deprecated: true
         contexts:
           type: array
           items:
@@ -1028,11 +1029,9 @@ components:
           intents: 
             listensFor: 
               ViewChart: 
-                displayName: View Chart
                 contexts: 
                   - fdc3.instrument
               myApp.GetPrice: 
-                displayName: Get Price
                 contexts: 
                   - fdc3.instrument
                 resultType: myApp.quote
@@ -1143,11 +1142,9 @@ components:
               intents: 
                 listensFor: 
                   ViewChart: 
-                    displayName: View Chart
                     contexts: 
                       - fdc3.instrument
                   myApp.GetPrice: 
-                    displayName: Get Price
                     contexts: 
                       - fdc3.instrument
                     resultType: myApp.quote