Merge branch 'main' into live

Author: github-actions

docs/develop/auth-save-passwords.md

@@ -0,0 +1,57 @@
+---
+title: Automatically save passwords in Microsoft Edge WebView2
+description: Learn how to enable WebView2 to save passwords when users sign in using your add-in.
+ms.localizationpriority: medium
+ms.date: 03/10/2025
+---
+
+# Enable automatic password saving in Microsoft Edge WebView2
+
+Most browsers can automatically save passwords on behalf of the user when they sign in. This helps users manage passwords in a secure environment. Microsoft Edge WebView2 also supports automatic password saving. When your add-in is loaded in Microsoft Office on Windows, Webview2 hosts your add-in. To enable automatic password saving, add HTML input controls for the username and password, as shown in the following HTML.
+
+```html
+<div>
+    <label for="username">Username:</label><br/>
+    <input type="text" id="username" name="username" /><br/>
+    
+    <label for="password">Password:</label><br/>
+    <input type="password" id="password" name="password" /><br/>
+    
+    <button id="btn" type="button">Sign in</button>
+</div>
+```
+
+In the button click event handler for the sign-in button, call the authentication library of your choice to sign in the user. Once the sign-in is complete, redirect to a new web page. When WebView2 sees the redirect, and the username and password, it prompts the user to offer to automatically save the credentials. The following code shows how to handle the sign-in button click event.
+
+```javascript
+async function btnSignIn() {
+  // Get the username and password credentials entered by the user.
+  const username = document.getElementById("username").value;
+  const pwd = document.getElementById("password").value;
+
+  try {
+    // Sign in the user. This is a placeholder for the actual sign-in logic.
+    await signInUser(username, pwd);
+
+    // Redirect to a success page to trigger the password autosave.
+    window.location.href = "/home.html";
+  }
+  catch (error) {
+    console.error("Sign in failed: " + error);
+    return;
+  }
+}
+```
+
+## How the user manages passwords
+
+When the user enters a new password in your add-in, and your add-in redirects to a new web page, WebView2 asks the user if they want to save their username and password. The next time your add-in prompts for credentials, WebView2 automatically enters the user's account information.
+
+:::image type="content" source="../images/edge-webview2-automatic-save-passwords.png" alt-text="The dialog from WebView2 prompting the user if they want to save their username and password.":::
+
+Users remove saved passwords by deleting The WebView2 local cache folder at `%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\webview2\`. If your add-in relies on automatically saving passwords, you should document this folder location so users can remove their passwords.
+
+## Related content
+
+- [Microsoft Edge WebView2](https://developer.microsoft.com/microsoft-edge/webview2)
+- [Browsers and webview controls used by Office Add-ins](../concepts/browsers-used-by-office-web-add-ins.md)

docs/develop/teams-toolkit-overview.md

@@ -1,7 +1,7 @@
 ---
 title: Create Office Add-in projects using Teams Toolkit
 description: Learn how to create Office Add-in projects using Teams Toolkit.
-ms.date: 02/12/2025
+ms.date: 04/10/2025
 ms.localizationpriority: high
 ---
 
@@ -38,8 +38,6 @@ Install the latest version of Teams Toolkit into Visual Studio Code as described
 
     :::image type="content" source="../images/teams-toolkit-create-office-task-pane-capability.png" alt-text="The options in the App Features Using an Office Add-in dropdown menu. The option 'Task pane' is selected.":::
 
-1. If you're making an Outlook add-in, the toolkit shows a **Programming Language** dropdown menu. Select either **TypeScript** or **JavaScript**. (For Excel, PowerPoint, and Word add-ins, a TypeScript project is always created.)
-1. If you're making an Outlook add-in, the toolkit shows a **Framework** dropdown menu. Select **Default** or **React**. (For Excel, PowerPoint, and Word add-ins, a default project is always created.)
 1. In the **Workspace Folder** dialog that opens, select the folder where you want to create the project.
 1. Give a name to the project (with no spaces) when prompted. Teams Toolkit will create the project with basic files and scaffolding. It will then open the project *in a second Visual Studio Code window*. Close the original Visual Studio Code window.
 
@@ -72,8 +70,14 @@ Install the latest version of Teams Toolkit into Visual Studio Code as described
 
 1. To stop debugging and uninstall the add-in, select **Run** | **Stop Debugging** in Visual Studio Code.
 
+   > [!NOTE]
+   > If the preceding step seems to have no effect, uninstall the add-in by opening a **TERMINAL** in Visual Studio Code, and then running the command `npm run stop`. Closing the server window doesn't reliably stop the server and closing the Office application doesn't reliably cause Office to unacquire the add-in.
+
 ### Sideload in Outlook
 
+> [!NOTE]
+> If your development computer is Windows, be sure that your Outlook client is classic Outlook for Windows, not [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627). There is currently a bug that prevents add-ins created with the Teams Toolkit from properly sideloading in new Outlook for Windows or in Outlook on the web.
+
 1. Ensure that your account in your Microsoft 365 developer tenancy is also an email account in desktop Outlook. If it isn't, follow the guidance in [Add an email account to Outlook](https://support.microsoft.com/office/e9da47c4-9b89-4b49-b945-a204aeea6726).
 1. **Close Outlook desktop**.
 1. In Visual Studio Code, open Teams Toolkit.
@@ -91,6 +95,9 @@ Install the latest version of Teams Toolkit into Visual Studio Code as described
 
 1. To stop debugging and uninstall the add-in, select **Run** | **Stop Debugging** in Visual Studio Code.
 
-## Developing your project
+   > [!NOTE]
+   > If the preceding step seems to have no effect, uninstall the add-in by opening a **TERMINAL** in Visual Studio Code, and then running the command `npm run stop`. Closing the server window doesn't reliably stop the server and closing the Office application doesn't reliably cause Office to unacquire the add-in.
+
+## Develop your project
 
 Now you can change and develop the project. In places where the guidance in the Office Add-ins documentation branches depending on what type of manifest is being used, be sure to follow the guidance for the unified manifest.

docs/images/edge-webview2-automatic-save-passwords.png

@@ -71,7 +71,7 @@ The following parameter values are used for the Script Lab installation link.
 
 To create the link, use the following URL template as a reference.
 
-`{{appName}}:https://api.addins.store.office.com/addinstemplate/{{language}}/{{correlationID}}/{{addinId}}/none/{{addinName}}.{{fileFormat}}?omexsrctype=1`
+`{{appName}}:https://api.addins.store.office.com/addinstemplate/{{language}}/{{correlationID}}/{{addinId}}/none/{{addinName}}.{{fileFormat}}?omexsrctype=1&isexternallink=1`
 
 Change the placeholders in the URL as follows.
 
@@ -93,7 +93,7 @@ Change the placeholders in the URL as follows.
 
 For example, the following is an installation link for Script Lab in Word on Windows with en-US as the language.
 
-`ms-word:https://api.addins.store.office.com/addinstemplate/en-US/228a829b-69d7-45f4-a338-c6aba330ec7e/WA104380862/none/Script%20Lab,%20a%20Microsoft%20Garage%20project.docx?omexsrctype=1`
+`ms-word:https://api.addins.store.office.com/addinstemplate/en-US/228a829b-69d7-45f4-a338-c6aba330ec7e/WA104380862/none/Script%20Lab,%20a%20Microsoft%20Garage%20project.docx?omexsrctype=1&isexternallink=1`
 
 ### Include the add-in in the installation of a Windows app or COM/VSTO add-in
 

docs/publish/publish-office-add-ins-to-appsource.md

@@ -185,6 +185,8 @@ items:
         href: develop/auth-external-add-ins.md
       - name: Access Microsoft Graph
         href: develop/authorize-to-microsoft-graph-without-sso.md
+      - name: Automatically save passwords in WebView2
+        href: develop/auth-save-passwords.md
     - name: UI and UX
       items:
       - name: Overview