Automatically generated docs (#2286)

Co-authored-by: github-actions <[email protected]>

Author: ElizabethSamuel-MSFT

docs/docs-ref-autogen/outlook/outlook/office.appointmentcompose.yml

@@ -566,9 +566,18 @@ properties:
       -->**: Appointment Organizer
 
 
-      **Important**: This property isn't supported in Outlook on Android or
-      on iOS. For more information on supported APIs in Outlook mobile, see
-      [Outlook JavaScript APIs supported in Outlook on mobile
+      **Important**:
+
+
+      - To learn about the different types of notification messages you can
+      implement, see [Create notifications for your Outlook
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+      -->.
+
+
+      - This property isn't supported in Outlook on Android or on iOS. For more
+      information on supported APIs in Outlook mobile, see [Outlook JavaScript
+      APIs supported in Outlook on mobile
       devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!--
       -->.
 

docs/docs-ref-autogen/outlook/outlook/office.appointmentread.yml

@@ -755,9 +755,18 @@ properties:
       -->**: Appointment Attendee
 
 
-      **Important**: This property isn't supported in Outlook on Android or
-      on iOS. For more information on supported APIs in Outlook mobile, see
-      [Outlook JavaScript APIs supported in Outlook on mobile
+      **Important**:
+
+
+      - To learn about the different types of notification messages you can
+      implement, see [Create notifications for your Outlook
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+      -->.
+
+
+      - This property isn't supported in Outlook on Android or on iOS. For more
+      information on supported APIs in Outlook mobile, see [Outlook JavaScript
+      APIs supported in Outlook on mobile
       devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!--
       -->.
 

docs/docs-ref-autogen/outlook/outlook/office.loadedmessagecompose.yml

@@ -419,8 +419,17 @@ properties:
       -->**: Message Compose
 
 
-      **Important**: Only the `getAllAsync` method of the
-      NotificationMessages object is supported.
+      **Important**:
+
+
+      - To learn about the different types of notification messages you can
+      implement, see [Create notifications for your Outlook
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+      -->.
+
+
+      - Only the `getAllAsync` method of the NotificationMessages object is
+      supported.
 
     isPreview: false
     isDeprecated: false

docs/docs-ref-autogen/outlook/outlook/office.loadedmessageread.yml

@@ -580,6 +580,12 @@ properties:
       **Important**:
 
 
+      - To learn about the different types of notification messages you can
+      implement, see [Create notifications for your Outlook
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+      -->.
+
+
       - Only the `getAllAsync` method of the NotificationMessages object is
       supported.
 

docs/docs-ref-autogen/outlook/outlook/office.messagecompose.yml

@@ -753,6 +753,12 @@ properties:
       -->**: Message Compose
 
 
+      **Important**: To learn about the different types of notification
+      messages you can implement, see [Create notifications for your Outlook
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+      -->.
+
+
       #### Examples
 
 

docs/docs-ref-autogen/outlook/outlook/office.messageread.yml

@@ -971,6 +971,12 @@ properties:
       -->**: Message Read
 
 
+      **Important**: To learn about the different types of notification
+      messages you can implement, see [Create notifications for your Outlook
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+      -->.
+
+
       #### Examples
 
 

docs/docs-ref-autogen/outlook/outlook/office.notificationmessagedetails.yml

@@ -21,6 +21,12 @@ remarks: >-
   -->**: Compose or Read
 
 
+  **Important**: To learn about the different types of notification messages
+  you can implement, see [Create notifications for your Outlook
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+  -->.
+
+
   #### Examples
 
 
@@ -84,13 +90,42 @@ properties:
     package: outlook!
     fullName: icon
     summary: >-
-      A reference to an icon that's defined in the manifest. It appears in the
-      infobar area. It's applicable if the type is `InformationalMessage`<!--
-      -->, and is required if the type is `InsightMessage`<!-- -->. Specifying
-      this parameter for an unsupported type results in an exception.
+      A reference to a custom icon that's defined in the manifest. The icon
+      appears before the notification message in the infobar area. An icon must
+      be specified for `InformationalMessage` and `InsightMessage`
+      notifications.
     remarks: >-
-      **Important**: Currently, the custom icon is only displayed in classic
-      Outlook on Windows.
+      **Important**:
+
+
+      - Currently, the custom icon is only displayed in classic Outlook on
+      Windows.
+
+
+      - A custom icon is only supported in `InformationalMessage` and
+      `InsightMessage` notifications. Specifying an icon for other notification
+      types results in an exception.
+
+
+      - If your add-in uses the [add-in only
+      manifest](https://learn.microsoft.com/office/dev/add-ins/develop/add-in-manifests)<!--
+      -->, the icon must be specified in the
+      [Images](https://learn.microsoft.com/javascript/api/manifest/images)
+      element of the
+      [Resources](https://learn.microsoft.com/javascript/api/manifest/resources)
+      section of the manifest.
+
+
+      - If your add-in uses the [unified manifest for Microsoft
+      365](https://learn.microsoft.com/office/dev/add-ins/develop/unified-manifest-overview)<!--
+      -->, you can't currently customize the icon of an `InformationalMessage`
+      or `InsightMessage` notification. The notification uses the first image
+      specified in the
+      ["icons"](https://learn.microsoft.com/microsoft-365/extensibility/schema/extension-common-icon)
+      array of the first
+      [extensions.ribbons.tabs.groups.controls](https://learn.microsoft.com/microsoft-365/extensibility/schema/extension-common-custom-group-controls-item)
+      object of the manifest. Although this is the case, you must still specify
+      a string in the `icon` property (for example, "icon-16").
 
     isPreview: false
     isDeprecated: false

docs/docs-ref-autogen/outlook/outlook/office.notificationmessages.yml

@@ -20,6 +20,12 @@ remarks: >-
   mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!--
   -->**: Compose or Read
 
+
+  **Important**: To learn about the different types of notification messages
+  you can implement, see [Create notifications for your Outlook
+  add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+  -->.
+
 isPreview: false
 isDeprecated: false
 type: interface

docs/docs-ref-autogen/outlook_1_10/outlook/office.appointmentcompose.yml

@@ -504,9 +504,18 @@ properties:
       -->**: Appointment Organizer
 
 
-      **Important**: This property isn't supported in Outlook on Android or
-      on iOS. For more information on supported APIs in Outlook mobile, see
-      [Outlook JavaScript APIs supported in Outlook on mobile
+      **Important**:
+
+
+      - To learn about the different types of notification messages you can
+      implement, see [Create notifications for your Outlook
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+      -->.
+
+
+      - This property isn't supported in Outlook on Android or on iOS. For more
+      information on supported APIs in Outlook mobile, see [Outlook JavaScript
+      APIs supported in Outlook on mobile
       devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!--
       -->.
 

docs/docs-ref-autogen/outlook_1_10/outlook/office.appointmentread.yml

@@ -717,9 +717,18 @@ properties:
       -->**: Appointment Attendee
 
 
-      **Important**: This property isn't supported in Outlook on Android or
-      on iOS. For more information on supported APIs in Outlook mobile, see
-      [Outlook JavaScript APIs supported in Outlook on mobile
+      **Important**:
+
+
+      - To learn about the different types of notification messages you can
+      implement, see [Create notifications for your Outlook
+      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/notifications)<!--
+      -->.
+
+
+      - This property isn't supported in Outlook on Android or on iOS. For more
+      information on supported APIs in Outlook mobile, see [Outlook JavaScript
+      APIs supported in Outlook on mobile
       devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!--
       -->.