Merge branch 'main' into live

github-actions · github-actions · commit bbf0266eae56 · 2025-01-07T22:06:37.000Z
diff --git a/docs/develop/manifest-element-ordering.md b/docs/develop/manifest-element-ordering.md
@@ -137,8 +137,8 @@ The following sections show the manifest elements in the order in which they mus
     <DefaultSettings>
         <SourceLocation>
             <Override>
-    <RequestedWidth>
-    <RequestedHeight>
+        <RequestedWidth>
+        <RequestedHeight>
     <Permissions>
     <AllowSnapshot>
     <VersionOverrides>*
diff --git a/docs/excel/custom-functions-debugging.md b/docs/excel/custom-functions-debugging.md
@@ -1,7 +1,7 @@
 ---
 title: Custom functions debugging in a non-shared runtime
 description: Learn how to debug your Excel custom functions that don't use a shared runtime.
-ms.date: 12/26/2024
+ms.date: 01/03/2024
 ms.topic: troubleshooting
 ms.localizationpriority: medium
 ---
@@ -71,7 +71,7 @@ If you aren't using VS Code, you can use the command line (such as bash, or Powe
   
     Or if you prefer to start your add-in in Excel on the web run the following command.
   
-    `npm run start:web -- --document {url}` (where `{url}` is the URL of an Excel file on OneDrive or SharePoint)
+    `npm run start -- web --document {url}` (where `{url}` is the URL of an Excel file on OneDrive or SharePoint)
   
     [!include[Mac command line note](../includes/mac-command-line.md)]
   
@@ -95,7 +95,7 @@ There are several build tasks available.
 You can use the following tasks to start debugging on desktop or online.
 
 - `npm run start:desktop`: Starts Excel on desktop and sideloads your add-in. If the "start:desktop" script isn't present in the "scripts" section of the project's package.json file, then run `npm run start` instead.
-- `npm run start:web -- --document {url}` (where `{url}` is the URL of an Excel file on OneDrive or SharePoint): Starts Excel on the web and sideloads your add-in.
+- `npm run start -- web --document {url}` (where `{url}` is the URL of an Excel file on OneDrive or SharePoint): Starts Excel on the web and sideloads your add-in.
 
   [!include[Mac command line note](../includes/mac-command-line.md)]
 
diff --git a/docs/images/azure-portal-manifest-token-version.png b/docs/images/azure-portal-manifest-token-version.png
diff --git a/docs/images/azure-portal-manifest.png b/docs/images/azure-portal-manifest.png
diff --git a/docs/includes/quickstart-yo-start-server-excel.md b/docs/includes/quickstart-yo-start-server-excel.md
@@ -18,4 +18,4 @@ Complete the following steps to start the local web server and sideload your add
 
 - To test your add-in in Excel on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of an Excel document on your OneDrive or a SharePoint library to which you have permissions.
 
-    [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+    [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
diff --git a/docs/includes/register-sso-add-in-aad-v2-include.md b/docs/includes/register-sso-add-in-aad-v2-include.md
@@ -181,7 +181,7 @@ The access token version can change if you chose an account type other than **Ac
 
     The Azure Active Directory application manifest appears.
 
-1. Enter **2** as the value for the `accessTokenAcceptedVersion` property.
+1. Enter **2** as the value for the `requestedAccessTokenVersion` property (in the `api` object).
 
     :::image type="content" source="../images/azure-portal-manifest-token-version.png" alt-text="Value for accepted access token version.":::
 
diff --git a/docs/includes/start-web-sideload-instructions.md b/docs/includes/start-web-sideload-instructions.md
@@ -2,13 +2,13 @@
 > If you are developing on a Mac, enclose the `{url}` in single quotation marks. Do *not* do this on Windows.
 
 ```command&nbsp;line
-npm run start:web -- --document {url}
+npm run start -- web --document {url}
 ```
 
 The following are examples.
 
-- `npm run start:web -- --document https://contoso.sharepoint.com/:t:/g/EZGxP7ksiE5DuxvY638G798BpuhwluxCMfF1WZQj3VYhYQ?e=F4QM1R`
-- `npm run start:web -- --document https://1drv.ms/x/s!jkcH7spkM4EGgcZUgqthk4IK3NOypVw?e=Z6G1qp`
-- `npm run start:web -- --document https://contoso-my.sharepoint-df.com/:t:/p/user/EQda453DNTpFnl1bFPhOVR0BwlrzetbXvnaRYii2lDr_oQ?e=RSccmNP`
+- `npm run start -- web --document https://contoso.sharepoint.com/:t:/g/EZGxP7ksiE5DuxvY638G798BpuhwluxCMfF1WZQj3VYhYQ?e=F4QM1R`
+- `npm run start -- web --document https://1drv.ms/x/s!jkcH7spkM4EGgcZUgqthk4IK3NOypVw?e=Z6G1qp`
+- `npm run start -- web --document https://contoso-my.sharepoint-df.com/:t:/p/user/EQda453DNTpFnl1bFPhOVR0BwlrzetbXvnaRYii2lDr_oQ?e=RSccmNP`
 
 If your add-in doesn't sideload in the document, manually sideload it by following the instructions in [Manually sideload add-ins to Office on the web](../testing/sideload-office-add-ins-for-testing.md#manually-sideload-an-add-in-to-office-on-the-web).
diff --git a/docs/includes/tutorial-excel-start-server.md b/docs/includes/tutorial-excel-start-server.md
@@ -8,5 +8,5 @@ If the local web server is already running and your add-in is already loaded in
 
 - To test your add-in in Excel on the web, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of an Excel document on your OneDrive or a SharePoint library to which you have permissions.
 
-    [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+    [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
diff --git a/docs/includes/tutorial-word-start-server.md b/docs/includes/tutorial-word-start-server.md
@@ -8,5 +8,5 @@ If the local web server is already running and your add-in is already loaded in
 
 - To test your add-in in Word on the web, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a Word document on your OneDrive or a SharePoint library to which you have permissions.
 
-    [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+    [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
diff --git a/docs/quickstarts/excel-custom-functions-quickstart.md b/docs/quickstarts/excel-custom-functions-quickstart.md
@@ -46,7 +46,7 @@ To start, you'll use the Yeoman generator to create the custom functions project
 
 To test your add-in in Excel on the web, run the following command. When you run this command, the local web server will start. Replace "{url}" with the URL of an Excel document on your OneDrive or a SharePoint library to which you have permissions.
 
-[!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+[!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 [!INCLUDE [alert use https](../includes/alert-use-https.md)]
 
diff --git a/docs/quickstarts/fluent-react-quickstart.md b/docs/quickstarts/fluent-react-quickstart.md
@@ -84,7 +84,7 @@ The add-in project that you've created with the Yeoman generator contains sample
 
     - To test your add-in in Excel, Word, or PowerPoint on the web, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a Word document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
     > [!NOTE]
     > If this is the first time that you have sideloaded an Office add-in on your computer (or the first time in over a month), you're prompted first to delete an old certificate and then to install a new one. Agree to both prompts.
diff --git a/docs/quickstarts/powerpoint-quickstart-yo.md b/docs/quickstarts/powerpoint-quickstart-yo.md
@@ -58,7 +58,7 @@ After you complete the wizard, the generator creates the project and installs su
 
     - To test your add-in in PowerPoint on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a PowerPoint document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. In PowerPoint, insert a new blank slide, choose the **Home** tab, and then choose the **Show Taskpane** button on the ribbon to open the add-in task pane.
 
diff --git a/docs/quickstarts/word-quickstart-yo.md b/docs/quickstarts/word-quickstart-yo.md
@@ -88,7 +88,7 @@ After you complete the wizard, the generator creates the project and installs su
 
     - To test your add-in in Word on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a Word document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. In Word, if the "My Office Add-in" task pane isn't already open, open a new document, choose the **Home** tab, and then choose the **Show Taskpane** button on the ribbon to open the add-in task pane.
 
diff --git a/docs/testing/sideload-office-add-ins-for-testing.md b/docs/testing/sideload-office-add-ins-for-testing.md
@@ -38,7 +38,7 @@ This process is supported for **Excel**, **OneNote**, **PowerPoint**, and **Word
 
 1. Open a Command Prompt as an administrator. In the command line starting at the root directory of your project, run the following command. Replace "{url}" with the URL that you copied.
 
-    [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+    [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. The first time you use this method to sideload an add-in on the web, you'll see a dialog asking you to enable developer mode. Select the checkbox for **Enable Developer Mode now** and select **OK**.
 
diff --git a/docs/tutorials/excel-tutorial-create-custom-functions.md b/docs/tutorials/excel-tutorial-create-custom-functions.md
@@ -66,7 +66,7 @@ The command to test your add-in in Excel on Windows or Mac depends on when the p
 
 To test your add-in in Excel on the web, run the following command. When you run this command, the local web server will start. Replace "{url}" with the URL of an Excel document on your OneDrive or a SharePoint library to which you have permissions.
 
-[!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+[!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 [!INCLUDE [alert use https](../includes/alert-use-https.md)]
 
diff --git a/docs/tutorials/excel-tutorial.md b/docs/tutorials/excel-tutorial.md
@@ -189,7 +189,7 @@ In this step of the tutorial, you'll programmatically test that your add-in supp
 
     - To test your add-in in Excel on the web, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of an Excel document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. In Excel, choose the **Home** tab, and then choose the **Show Taskpane** button on the ribbon to open the add-in task pane.
 
@@ -689,7 +689,7 @@ These steps must be completed whenever your code needs to *read* information fro
 
     - To test your add-in in Excel on the web, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of an Excel document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. On the **Home** tab in Excel, choose the **Toggle Worksheet Protection** button. Note that most of the controls on the ribbon are disabled (and visually grayed-out) as seen in the following screenshot.
 
diff --git a/docs/tutorials/powerpoint-tutorial-yo.md b/docs/tutorials/powerpoint-tutorial-yo.md
@@ -221,7 +221,7 @@ Complete the following steps to add code that inserts an image into a slide.
 
     - To test your add-in in PowerPoint on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a PowerPoint document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. If the add-in task pane isn't already open in PowerPoint, choose the **Home** tab, and then choose the **Show Taskpane** button on the ribbon to open the add-in task pane.
 
@@ -274,7 +274,7 @@ Complete the following steps to add markup that customizes the task pane UI.
 
     - To test your add-in in PowerPoint on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a PowerPoint document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. If the add-in task pane isn't already open in PowerPoint, select the **Show Taskpane** button on the ribbon to open it.
 
@@ -341,7 +341,7 @@ Complete the following steps to add code that inserts text into the title slide
 
     - To test your add-in in PowerPoint on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a PowerPoint document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. If the add-in task pane isn't already open in PowerPoint, select the **Show Taskpane** button on the ribbon to open it.
 
@@ -416,7 +416,7 @@ Complete the following steps to add code that retrieves metadata for the selecte
 
     - To test your add-in in PowerPoint on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a PowerPoint document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. If the add-in task pane isn't already open in PowerPoint, select the **Show Taskpane** button on the ribbon to open it.
 
@@ -527,7 +527,7 @@ Complete the following steps to add code that navigates between the slides of a
 
     - To test your add-in in PowerPoint on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a PowerPoint document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. If the add-in task pane isn't already open in PowerPoint, select the **Show Taskpane** button on the ribbon to open it.
 
diff --git a/docs/tutorials/word-tutorial.md b/docs/tutorials/word-tutorial.md
@@ -141,7 +141,7 @@ In this step of the tutorial, you'll programmatically test that your add-in supp
 
     - To test your add-in in Word on the web, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a Word document on your OneDrive or a SharePoint library to which you have permissions.
 
-        [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]
+        [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]
 
 1. In Word, if the "My Office Add-in" task pane isn't already open, choose the **Home** tab, and then choose the **Show Taskpane** button on the ribbon to open the add-in task pane.
 

Original file line number	Diff line number	Diff line change
`@@ -18,4 +18,4 @@ Complete the following steps to start the local web server and sideload your add`
`18`	`18`
`19`	`19`	`- To test your add-in in Excel on a browser, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of an Excel document on your OneDrive or a SharePoint library to which you have permissions.`
`20`	`20`
`21`		`- [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]`
	`21`	`+ [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]`
Original file line number	Diff line number	Diff line change
`@@ -8,5 +8,5 @@ If the local web server is already running and your add-in is already loaded in`
`8`	`8`
`9`	`9`	`- To test your add-in in Excel on the web, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of an Excel document on your OneDrive or a SharePoint library to which you have permissions.`
`10`	`10`
`11`		`- [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]`
	`11`	`+ [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]`
`12`	`12`
Original file line number	Diff line number	Diff line change
`@@ -8,5 +8,5 @@ If the local web server is already running and your add-in is already loaded in`
`8`	`8`
`9`	`9`	`- To test your add-in in Word on the web, run the following command in the root directory of your project. When you run this command, the local web server starts. Replace "{url}" with the URL of a Word document on your OneDrive or a SharePoint library to which you have permissions.`
`10`	`10`
`11`		`- [!INCLUDE [npm start:web command syntax](../includes/start-web-sideload-instructions.md)]`
	`11`	`+ [!INCLUDE [npm start on web command syntax](../includes/start-web-sideload-instructions.md)]`
`12`	`12`