Merge branch 'main' into live

Author: github-actions

docs/docs-ref-autogen/office/office/office.context.yml

@@ -205,8 +205,9 @@ properties:
     fullName: diagnostics
     summary: Gets information about the environment in which the add-in is running.
     remarks: >-
-      **Important**: In Outlook, this property is available from Mailbox
-      requirement set 1.5. For all Mailbox requirement sets, you can use the
+      **Important**: In Outlook, this property is available starting with
+      Mailbox requirement set 1.5. For all Mailbox requirement sets, you can use
+      the
       [Office.context.mailbox.diagnostics](https://learn.microsoft.com/javascript/api/outlook/office.mailbox?view=outlook-js-preview&preserve-view=true#outlook-office-mailbox-diagnostics-member)
       property to get similar information.
 
@@ -348,10 +349,10 @@ properties:
     fullName: host
     summary: Contains the Office application in which the add-in is running.
     remarks: >-
-      **Important**: In Outlook, this property is available from Mailbox
-      requirement set 1.5. You can also use the `Office.context.diagnostics`
-      property to get the application starting with requirement set 1.5. For all
-      Mailbox requirement sets, you can use the
+      **Important**: In Outlook, this property is available starting with
+      Mailbox requirement set 1.5. You can also use the
+      `Office.context.diagnostics` property to get the application starting with
+      requirement set 1.5. For all Mailbox requirement sets, you can use the
       [Office.context.mailbox.diagnostics](https://learn.microsoft.com/javascript/api/outlook/office.mailbox?view=outlook-js-preview&preserve-view=true#outlook-office-mailbox-diagnostics-member)
       property to get similar information.
 
@@ -569,10 +570,10 @@ properties:
       **Important**:
 
 
-      - In Outlook, this property is available from Mailbox requirement set 1.5.
-      You can also use the `Office.context.diagnostics` property to get the
-      platform starting with requirement set 1.5. For all Mailbox requirement
-      sets, you can use the
+      - In Outlook, this property is available starting with Mailbox requirement
+      set 1.5. You can also use the `Office.context.diagnostics` property to get
+      the platform starting with requirement set 1.5. For all Mailbox
+      requirement sets, you can use the
       [Office.context.mailbox.diagnostics](https://learn.microsoft.com/javascript/api/outlook/office.mailbox?view=outlook-js-preview&preserve-view=true#outlook-office-mailbox-diagnostics-member)
       property to get similar information.
 

docs/docs-ref-autogen/office/office/office.contextinformation.yml

@@ -5,7 +5,7 @@ package: office!
 fullName: Office.ContextInformation
 summary: Provides information about the environment in which the add-in is running.
 remarks: >-
-  **Important**: In Outlook, this object is available from Mailbox
+  **Important**: In Outlook, this object is available starting with Mailbox
   requirement set 1.5. For all Mailbox requirement sets, you can use the
   [Office.context.mailbox.diagnostics](https://learn.microsoft.com/javascript/api/outlook/office.mailbox?view=outlook-js-preview&preserve-view=true#outlook-office-mailbox-diagnostics-member)
   property to get similar information.

docs/docs-ref-autogen/office/office/office.hosttype.yml

@@ -5,8 +5,8 @@ package: office!
 fullName: Office.HostType
 summary: Specifies the Office application in which the add-in is running.
 remarks: >-
-  **Important**: In Outlook, this enum is available from Mailbox requirement
-  set 1.5.
+  **Important**: In Outlook, this enum is available starting with Mailbox
+  requirement set 1.5.
 
 
   #### Examples

docs/docs-ref-autogen/office/office/office.platformtype.yml

@@ -5,8 +5,8 @@ package: office!
 fullName: Office.PlatformType
 summary: Specifies the OS or other platform on which the Office application is running.
 remarks: >-
-  **Important**: In Outlook, this enum is available from Mailbox requirement
-  set 1.5.
+  **Important**: In Outlook, this enum is available starting with Mailbox
+  requirement set 1.5.
 
 
   #### Examples

docs/docs-ref-autogen/office_release/office/office.context.yml

@@ -174,8 +174,9 @@ properties:
     fullName: diagnostics
     summary: Gets information about the environment in which the add-in is running.
     remarks: >-
-      **Important**: In Outlook, this property is available from Mailbox
-      requirement set 1.5. For all Mailbox requirement sets, you can use the
+      **Important**: In Outlook, this property is available starting with
+      Mailbox requirement set 1.5. For all Mailbox requirement sets, you can use
+      the
       [Office.context.mailbox.diagnostics](https://learn.microsoft.com/javascript/api/outlook/office.mailbox?view=outlook-js-1.1&preserve-view=true#outlook-office-mailbox-diagnostics-member)
       property to get similar information.
 
@@ -317,10 +318,10 @@ properties:
     fullName: host
     summary: Contains the Office application in which the add-in is running.
     remarks: >-
-      **Important**: In Outlook, this property is available from Mailbox
-      requirement set 1.5. You can also use the `Office.context.diagnostics`
-      property to get the application starting with requirement set 1.5. For all
-      Mailbox requirement sets, you can use the
+      **Important**: In Outlook, this property is available starting with
+      Mailbox requirement set 1.5. You can also use the
+      `Office.context.diagnostics` property to get the application starting with
+      requirement set 1.5. For all Mailbox requirement sets, you can use the
       [Office.context.mailbox.diagnostics](https://learn.microsoft.com/javascript/api/outlook/office.mailbox?view=outlook-js-1.1&preserve-view=true#outlook-office-mailbox-diagnostics-member)
       property to get similar information.
 
@@ -538,10 +539,10 @@ properties:
       **Important**:
 
 
-      - In Outlook, this property is available from Mailbox requirement set 1.5.
-      You can also use the `Office.context.diagnostics` property to get the
-      platform starting with requirement set 1.5. For all Mailbox requirement
-      sets, you can use the
+      - In Outlook, this property is available starting with Mailbox requirement
+      set 1.5. You can also use the `Office.context.diagnostics` property to get
+      the platform starting with requirement set 1.5. For all Mailbox
+      requirement sets, you can use the
       [Office.context.mailbox.diagnostics](https://learn.microsoft.com/javascript/api/outlook/office.mailbox?view=outlook-js-1.1&preserve-view=true#outlook-office-mailbox-diagnostics-member)
       property to get similar information.
 

docs/docs-ref-autogen/office_release/office/office.contextinformation.yml

@@ -5,7 +5,7 @@ package: office!
 fullName: Office.ContextInformation
 summary: Provides information about the environment in which the add-in is running.
 remarks: >-
-  **Important**: In Outlook, this object is available from Mailbox
+  **Important**: In Outlook, this object is available starting with Mailbox
   requirement set 1.5. For all Mailbox requirement sets, you can use the
   [Office.context.mailbox.diagnostics](https://learn.microsoft.com/javascript/api/outlook/office.mailbox?view=outlook-js-1.1&preserve-view=true#outlook-office-mailbox-diagnostics-member)
   property to get similar information.

docs/docs-ref-autogen/office_release/office/office.hosttype.yml

@@ -5,8 +5,8 @@ package: office!
 fullName: Office.HostType
 summary: Specifies the Office application in which the add-in is running.
 remarks: >-
-  **Important**: In Outlook, this enum is available from Mailbox requirement
-  set 1.5.
+  **Important**: In Outlook, this enum is available starting with Mailbox
+  requirement set 1.5.
 
 
   #### Examples

docs/docs-ref-autogen/office_release/office/office.platformtype.yml

@@ -5,8 +5,8 @@ package: office!
 fullName: Office.PlatformType
 summary: Specifies the OS or other platform on which the Office application is running.
 remarks: >-
-  **Important**: In Outlook, this enum is available from Mailbox requirement
-  set 1.5.
+  **Important**: In Outlook, this enum is available starting with Mailbox
+  requirement set 1.5.
 
 
   #### Examples

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

@@ -23,6 +23,61 @@ remarks: >-
   mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!--
   -->**: Compose
 
+
+  #### Examples
+
+
+  ```TypeScript
+
+  // Link to full sample:
+  https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/attachments-compose.yaml
+
+
+  Office.context.mailbox.item.getAttachmentsAsync((result) => {
+    if (result.status === Office.AsyncResultStatus.Failed) {
+      console.error(result.error.message);
+      return;
+    }
+
+    if (result.value.length > 0) {
+      for (let i = 0; i < result.value.length; i++) {
+        const attachment = result.value[i];
+        let attachmentType;
+        switch (attachment.attachmentType) {
+          case Office.MailboxEnums.AttachmentType.Cloud:
+            attachmentType = "Attachment is stored in a cloud location";
+            break;
+          case Office.MailboxEnums.AttachmentType.File:
+            attachmentType = "Attachment is a file";
+            break;
+          case Office.MailboxEnums.AttachmentType.Item:
+            attachmentType = "Attachment is an Exchange item";
+            break;
+        }
+        console.log(
+          "ID: " +
+            attachment.id +
+            "\n" +
+            "Type: " +
+            attachmentType +
+            "\n" +
+            "Name: " +
+            attachment.name +
+            "\n" +
+            "Size: " +
+            attachment.size +
+            "\n" +
+            "isInline: " +
+            attachment.isInline
+        );
+      }
+    } else {
+      console.log("No attachments on this message.");
+    }
+  });
+
+  ```
+
 isPreview: false
 isDeprecated: false
 type: interface

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

@@ -375,9 +375,10 @@ methods:
 
       - In Outlook on the web and [new Outlook on
       Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!--
-      -->, if the body contains formatted elements, such as tables, lists, and
-      links, specify `Office.CoercionType.Html` in the `getAsync` call.
-      Otherwise, you may receive an unexpected value, such as an empty string.
+      -->, specifying `Office.CoercionType.Text` in the `getAsync` call may not
+      always provide reliable formatting. Specify `Office.CoercionType.Html`
+      instead especially if the body contains formatted elements, such as
+      tables, lists, and links.
 
 
       - In Outlook on the web and new Outlook on Windows, users can organize
@@ -476,9 +477,10 @@ methods:
 
       - In Outlook on the web and [new Outlook on
       Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!--
-      -->, if the body contains formatted elements, such as tables, lists, and
-      links, specify `Office.CoercionType.Html` in the `getAsync` call.
-      Otherwise, you may receive an unexpected value, such as an empty string.
+      -->, specifying `Office.CoercionType.Text` in the `getAsync` call may not
+      always provide reliable formatting. Specify `Office.CoercionType.Html`
+      instead especially if the body contains formatted elements, such as
+      tables, lists, and links.
 
 
       - In Outlook on the web and new Outlook on Windows, users can organize