Merge branch 'main' into live

Author: github-actions

docs/develop/convert-xml-to-json-manifest.md

@@ -2,7 +2,7 @@
 title: Convert an add-in to use the unified manifest for Microsoft 365
 description: Learn the various methods for converting an add-in with an add-in only manifest to the unified manifest for Microsoft 365 and sideload the add-in.
 ms.topic: how-to
-ms.date: 03/26/2025
+ms.date: 04/18/2025
 ms.localizationpriority: medium
 ---
 
@@ -66,7 +66,7 @@ The following markup is an example.
 
 ### Reduce the number of add-in commands as needed
 
-An add-in that uses the unified manifest may not have more than 20 [add-in commands](../design/add-in-commands.md). If the total number of  [**\<Action\>** elements](/javascript/api/manifest/action) in the add-in only manifest is greater than 20, you must redesign the add-in to have no more than 20. 
+An add-in that uses the unified manifest may not have more than 20 [add-in commands](../design/add-in-commands.md). If the total number of  [**\<Action\>** elements](/javascript/api/manifest/action) in the add-in only manifest is greater than 20, you must redesign the add-in to have no more than 20.
 
 ### Update the add-in ID, version, domain, and function names in the manifest
 
@@ -81,6 +81,16 @@ An add-in that uses the unified manifest may not have more than 20 [add-in comma
    > [!IMPORTANT]
    > The value of this element must exactly match the name of an action that's mapped to a function in a JavaScript or TypeScript file with the [Office.actions.associate](/javascript/api/office/office.actions#office-office-actions-associate-member(1)) function. If you change it in the manifest, be sure to change it in the `actionId` parameter passed to `associate()` too.
 
+### Shorten string values as needed
+
+Review and change, as needed, the manifest values in light of the following effects of the conversion.
+
+- The first 30 characters of `<DisplayName>` becomes the value of "name.short" in the unified manifest.
+- The first 100 characters of `<DisplayName>` becomes the value of "name.long" in the unified manifest.
+- The first 250 characters of `<Description>` becomes the value of "description.short" in the unified manifest.
+- The first 4000 characters of `<Description>` becomes the value of "description.long" in the unified manifest.
+- The first 32 characters of the `<ProviderName>` becomes the value "developer.name" in the unified manifest.
+
 ### Verify that the modified add-in only manifest works
 
 1. Validate the modified add-in only manifest. See [Validate an Office Add-in's manifest](../testing/troubleshoot-manifest.md).

docs/outlook/mobile-event-based.md

@@ -1,7 +1,7 @@
 ---
 title: Implement event-based activation in Outlook mobile add-ins
 description: Learn how to develop an Outlook mobile add-in that implements event-based activation.
-ms.date: 03/11/2025
+ms.date: 04/22/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -260,7 +260,6 @@ To enable your add-in to complete tasks when the `OnNewMessageCompose` event occ
                     }
 
                     // Show a notification when the signature is added to the message.
-                    // Important: Only the InformationalMessage type is supported in Outlook mobile at this time.
                     const notification = {
                         type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
                         message: "Company signature added.",

docs/outlook/outlook-mobile-apis.md

@@ -1,7 +1,7 @@
 ---
 title: Outlook JavaScript APIs supported in Outlook on mobile devices
 description: Learn which Outlook JavaScript APIs are supported in Outlook on mobile devices.
-ms.date: 03/14/2025
+ms.date: 04/22/2025
 ms.localizationpriority: medium
 ---
 
@@ -51,6 +51,7 @@ Although Outlook mobile supports up to requirement set 1.5, there are some APIs
 |[Office.context.mailbox.item.displayReplyForm](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods)|Mailbox 1.1|<ul><li>Message Read</li><li>Appointment Attendee</li></ul>|
 |[Office.context.mailbox.item.getRegexMatches](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods)|Mailbox 1.1|<ul><li>Message Read</li><li>Appointment Attendee</li></ul>|
 |[Office.context.mailbox.item.getRegexMatchesByName](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods)|Mailbox 1.1|<ul><li>Message Read</li><li>Appointment Attendee</li></ul>|
+|[Office.context.mailbox.item.notificationMessages](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods)|Mailbox 1.3|<ul><li>Appointment Attendee</li><li>Appointment Organizer</li></ul>|
 |[Office.context.mailbox.item.bcc.addAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-addasync-member(1))<br><br>[Office.context.mailbox.item.cc.addAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-addasync-member(1))<br><br>[Office.context.mailbox.item.to.addAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-addasync-member(1))|Mailbox 1.1|<ul><li>Message Compose</li></ul>|
 |[Office.context.mailbox.item.bcc.setAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-setasync-member(1))<br><br>[Office.context.mailbox.item.cc.setAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-setasync-member(1))<br><br>[Office.context.mailbox.item.to.setAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-setasync-member(1))|Mailbox 1.1|<ul><li>Message Compose</li></ul>|
 |[Office.context.mailbox.item.body.getTypeAsync](/javascript/api/outlook/office.body#outlook-office-body-gettypeasync-member(1))|Mailbox 1.1|<ul><li>Message Compose</li></ul>|

docs/outlook/tips-for-handling-date-values-in-outlook-add-ins.md

@@ -1,11 +1,11 @@
 ---
-title: Handling date values in Outlook add-ins
+title: Handle date values in Outlook add-ins
 description: The Office JavaScript API uses the JavaScript Date object for most of the storage and retrieval of dates and times. 
-ms.date: 02/29/2024
+ms.date: 04/17/2025
 ms.localizationpriority: medium
 ---
 
-# Tips for handling date values in Outlook add-ins
+# Handle date values in Outlook add-ins
 
 The Office JavaScript API uses the JavaScript [Date](https://www.w3schools.com/jsref/jsref_obj_date.asp) object for most of the storage and retrieval of dates and times.