Automatically generated docs (#2255)

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

Author: samantharamon

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

@@ -532,6 +532,11 @@ 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
+      devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!-- -->.
+
+
       #### Examples
 
 

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

@@ -703,6 +703,11 @@ 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
+      devices](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis)<!-- -->.
+
+
       #### Examples
 
 

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

@@ -74,14 +74,10 @@ properties:
     package: outlook!
     fullName: icon
     summary: >-
-      A reference to an icon that is defined in the manifest. It appears in the infobar area. It is applicable if the
-      type is `InformationalMessage`<!-- -->, and is required if the type is `InsightMessage`<!-- -->. Specifying this
+      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.
-
-
-      **Note**: At present, the custom icon is displayed in Outlook on Windows only and not on other clients (e.g.,
-      Mac, web browser).
-    remarks: ''
+    remarks: '**Important**: Currently, the custom icon is only displayed in classic Outlook on Windows.'
     isPreview: false
     isDeprecated: false
     syntax:
@@ -134,21 +130,27 @@ properties:
     uid: 'outlook!Office.NotificationMessageDetails#type:member'
     package: outlook!
     fullName: type
-    summary: >-
-      Specifies the `ItemNotificationMessageType` of message.
+    summary: Specifies the `ItemNotificationMessageType` of message.
+    remarks: >-
+      **Important**:
 
 
-      If type is `ProgressIndicator` or `ErrorMessage`<!-- -->, an icon is automatically supplied and the message is not
-      persistent. Therefore the icon and persistent properties are not valid for these types of messages. Including them
+      - For the `ProgressIndicator` or `ErrorMessage` types, an icon is automatically supplied and the message isn't
+      persistent. Therefore, the icon and persistent properties aren't valid for these types of messages. Including them
       will result in an `ArgumentException`<!-- -->.
 
 
-      If type is `ProgressIndicator`<!-- -->, the developer should remove or replace the progress indicator when the
-      action is complete.
+      - For the `ProgressIndicator` type, you should remove or replace the progress indicator when the action is
+      complete.
 
 
-      **Important**: Only the `InformationalMessage` type is supported in Outlook on Android and on iOS.
-    remarks: ''
+      - In Outlook on Android and on iOS, only the `ProgressIndicator`<!-- -->, `InformationalMessage`<!-- -->, and
+      `ErrorMessage` notification types are supported.
+
+
+      - In compose mode, while the style of each notification type varies on other Outlook clients, notifications in
+      Outlook on Android and on iOS all use the same style. The notification message is always prefixed with an
+      informational icon.
     isPreview: false
     isDeprecated: false
     syntax:

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

@@ -24,12 +24,7 @@ methods:
     uid: 'outlook!Office.NotificationMessages#addAsync:member(1)'
     package: outlook!
     fullName: 'addAsync(key, JSONmessage, options, callback)'
-    summary: >-
-      Adds a notification to an item.
-
-
-      There are a maximum of 5 notifications per message. Setting more will return a
-      `NumberOfNotificationMessagesExceeded` error.
+    summary: Adds a notification to an item.
     remarks: >-
       \[ [API set: Mailbox 1.3](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -47,6 +42,11 @@ methods:
       **Important**:
 
 
+      - In Outlook on the web, on Windows (new and classic), and on Mac, you can set a maximum of five notifications per
+      message. Setting more returns a `NumberOfNotificationMessagesExceeded` error. In Outlook on Android and on iOS,
+      you can only set one notification per message. Setting an additional notification replaces the previous one.
+
+
       - Only one notification of type
       [InsightMessage](https://learn.microsoft.com/javascript/api/outlook/office.mailboxenums.itemnotificationmessagetype#fields)
       is allowed per add-in. Attempting to add more will throw an error.
@@ -57,7 +57,13 @@ methods:
       `InsightMessage` notification only in Compose mode.
 
 
-      - Only the `InformationalMessage` type is supported in Outlook on Android and on iOS.
+      - In Outlook on Android and on iOS, only the `ProgressIndicator`<!-- -->, `InformationalMessage`<!-- -->, and
+      `ErrorMessage` notification types are supported.
+
+
+      - In compose mode, while the style of each notification type varies on other Outlook clients, notifications in
+      Outlook on Android and on iOS all use the same style. The notification message is always prefixed with an
+      informational icon.
 
 
       - The `addAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
@@ -169,12 +175,7 @@ methods:
     uid: 'outlook!Office.NotificationMessages#addAsync:member(2)'
     package: outlook!
     fullName: 'addAsync(key, JSONmessage, callback)'
-    summary: >-
-      Adds a notification to an item.
-
-
-      There are a maximum of 5 notifications per message. Setting more will return a
-      `NumberOfNotificationMessagesExceeded` error.
+    summary: Adds a notification to an item.
     remarks: >-
       \[ [API set: Mailbox 1.3](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -192,6 +193,11 @@ methods:
       **Important**:
 
 
+      - In Outlook on the web, on Windows (new and classic), and on Mac, you can set a maximum of five notifications per
+      message. Setting more returns a `NumberOfNotificationMessagesExceeded` error. In Outlook on Android and on iOS,
+      you can only set one notification per message. Setting an additional notification replaces the previous one.
+
+
       - Only one notification of type
       [InsightMessage](https://learn.microsoft.com/javascript/api/outlook/office.mailboxenums.itemnotificationmessagetype#fields)
       is allowed per add-in. Attempting to add more will throw an error.
@@ -202,7 +208,13 @@ methods:
       `InsightMessage` notification only in Compose mode.
 
 
-      - Only the `InformationalMessage` type is supported in Outlook on Android and on iOS.
+      - In Outlook on Android and on iOS, only the `ProgressIndicator`<!-- -->, `InformationalMessage`<!-- -->, and
+      `ErrorMessage` notification types are supported.
+
+
+      - In compose mode, while the style of each notification type varies on other Outlook clients, notifications in
+      Outlook on Android and on iOS all use the same style. The notification message is always prefixed with an
+      informational icon.
 
 
       - The `addAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.

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

@@ -61,7 +61,7 @@ methods:
       There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
 
 
-      - The `addAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
+      The `addAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
       For more information, see [Activate your Outlook add-in on multiple
       messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
 
@@ -171,7 +171,7 @@ methods:
       There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
 
 
-      - The `addAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
+      The `addAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
       For more information, see [Activate your Outlook add-in on multiple
       messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
 
@@ -528,7 +528,7 @@ methods:
       There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
 
 
-      - The `setAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
+      The `setAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
       For more information, see [Activate your Outlook add-in on multiple
       messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
 
@@ -610,7 +610,7 @@ methods:
       There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
 
 
-      - The `setAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
+      The `setAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
       For more information, see [Activate your Outlook add-in on multiple
       messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
 

docs/docs-ref-autogen/outlook_1_1/outlook/office.body.yml

@@ -238,6 +238,11 @@ methods:
       - The `prependAsync` method doesn't support inline CSS. Use internal or external CSS instead.
 
 
+      - The `prependAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync`
+      method. For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       **Errors**:
 
 
@@ -367,6 +372,11 @@ methods:
       - The `prependAsync` method doesn't support inline CSS. Use internal or external CSS instead.
 
 
+      - The `prependAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync`
+      method. For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       **Errors**:
 
 
@@ -430,6 +440,11 @@ methods:
       - The `setSelectedDataAsync` method doesn't support inline CSS. Use internal or external CSS instead.
 
 
+      - The `setSelectedDataAsync` method isn't supported on a message that's currently loaded using the
+      `loadItemByIdAsync` method. For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       **Errors**:
 
 
@@ -547,6 +562,11 @@ methods:
       - The `setSelectedDataAsync` method doesn't support inline CSS. Use internal or external CSS instead.
 
 
+      - The `setSelectedDataAsync` method isn't supported on a message that's currently loaded using the
+      `loadItemByIdAsync` method. For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       **Errors**:
 
 

docs/docs-ref-autogen/outlook_1_1/outlook/office.customproperties.yml

@@ -111,6 +111,11 @@ methods:
       -->**: Compose or Read
 
 
+      **Important**: The `remove` method isn't supported on a message that's currently loaded using the
+      `loadItemByIdAsync` method. For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       #### Examples
 
 
@@ -275,6 +280,11 @@ methods:
       -->**: Compose or Read
 
 
+      **Important**: The `set` method isn't supported on a message that's currently loaded using the
+      `loadItemByIdAsync` method. For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       #### Examples
 
 

docs/docs-ref-autogen/outlook_1_1/outlook/office.recipients.yml

@@ -39,9 +39,12 @@ methods:
       -->**: Compose
 
 
-      **Important**: With the `addAsync` method, you can add a maximum of 100 recipients to a mail item in Outlook
-      on the web, on Windows ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) and
-      classic), on Mac (classic UI), on Android, and on iOS. However, take note of the following:
+      **Important**:
+
+
+      With the `addAsync` method, you can add a maximum of 100 recipients to a mail item in Outlook on the web, on
+      Windows ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) and classic), on Mac
+      (classic UI), on Android, and on iOS. However, take note of the following:
 
 
       - In Outlook on the web, on Windows (new and classic), and on Mac (classic UI), you can have a maximum of 500
@@ -58,6 +61,11 @@ methods:
       There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
 
 
+      The `addAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
+      For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       **Errors**:
 
 
@@ -142,9 +150,12 @@ methods:
       -->**: Compose
 
 
-      **Important**: With the `addAsync` method, you can add a maximum of 100 recipients to a mail item in Outlook
-      on the web, on Windows ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) and
-      classic), on Mac (classic UI), on Android, and on iOS. However, take note of the following:
+      **Important**:
+
+
+      With the `addAsync` method, you can add a maximum of 100 recipients to a mail item in Outlook on the web, on
+      Windows ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) and classic), on Mac
+      (classic UI), on Android, and on iOS. However, take note of the following:
 
 
       - In Outlook on the web, on Windows (new and classic), and on Mac (classic UI), you can have a maximum of 500
@@ -161,6 +172,11 @@ methods:
       There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
 
 
+      The `addAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
+      For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       **Errors**:
 
 
@@ -491,9 +507,12 @@ methods:
       -->**: Compose
 
 
-      **Important**: With the `setAsync` method, you can set a maximum of 100 recipients in Outlook on the web, on
-      Windows ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) and classic), on Mac
-      (classic UI), on Android, and on iOS. However, take note of the following:
+      **Important**:
+
+
+      With the `setAsync` method, you can set a maximum of 100 recipients in Outlook on the web, on Windows
+      ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) and classic), on Mac (classic
+      UI), on Android, and on iOS. However, take note of the following:
 
 
       - In Outlook on the web, on Windows (new and classic), and on Mac (classic UI), you can have a maximum of 500
@@ -510,6 +529,11 @@ methods:
       There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
 
 
+      The `setAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
+      For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       **Errors**:
 
 
@@ -565,9 +589,12 @@ methods:
       -->**: Compose
 
 
-      **Important**: With the `setAsync` method, you can set a maximum of 100 recipients in Outlook on the web, on
-      Windows ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) and classic), on Mac
-      (classic UI), on Android, and on iOS. However, take note of the following:
+      **Important**:
+
+
+      With the `setAsync` method, you can set a maximum of 100 recipients in Outlook on the web, on Windows
+      ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) and classic), on Mac (classic
+      UI), on Android, and on iOS. However, take note of the following:
 
 
       - In Outlook on the web, on Windows (new and classic), and on Mac (classic UI), you can have a maximum of 500
@@ -584,6 +611,11 @@ methods:
       There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
 
 
+      The `setAsync` method isn't supported on a message that's currently loaded using the `loadItemByIdAsync` method.
+      For more information, see [Activate your Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!-- -->.
+
+
       **Errors**: