From 76e016800fcfaeef34fe144f8244fead418c1767 Mon Sep 17 00:00:00 2001 From: "docsautomation[bot]" <198554515+docsautomation[bot]@users.noreply.github.com> Date: Fri, 4 Jul 2025 07:31:54 +0000 Subject: [PATCH] Update msteams-platform/tabs/how-to/create-personal-tab.md by Harsh-Chaturvedi-1 --- .../tabs/how-to/create-personal-tab.md | 845 ++++++++---------- 1 file changed, 378 insertions(+), 467 deletions(-) diff --git a/msteams-platform/tabs/how-to/create-personal-tab.md b/msteams-platform/tabs/how-to/create-personal-tab.md index 60511df88e9..329ec19f06a 100644 --- a/msteams-platform/tabs/how-to/create-personal-tab.md +++ b/msteams-platform/tabs/how-to/create-personal-tab.md @@ -11,13 +11,13 @@ ms.owner: ryanbliss # Create a tab -Tabs in chats, channels, or meetings behave more like apps, as you can pin only one tab per app to the left pane for easy access. +Tabs in chats, channels, or meetings behave more like apps because only one tab per app can be pinned to the left pane for easy access. > [!IMPORTANT] > -> We've introduced [Microsoft 365 Agents Toolkit](../../toolkit/agents-toolkit-fundamentals.md) (previously known as Teams Toolkit) extension within Visual Studio Code. This version comes to you with many new app development features. We recommend that you use Agents Toolkit v5 for building your Teams app. +> Microsoft has introduced [Microsoft 365 Agents Toolkit](../../toolkit/agents-toolkit-fundamentals.md) (previously known as Teams Toolkit) extension within Visual Studio Code. This version comes with many new app development features. Agents Toolkit v5 is recommended for building Teams apps. -Ensure that you've all the [prerequisites](~/tabs/how-to/tab-requirements.md) to build your tab. +Developers must ensure all [prerequisites](~/tabs/how-to/tab-requirements.md) are in place to build a tab. [!INCLUDE [sdk-include](~/includes/sdk-include.md)] @@ -53,13 +53,13 @@ Following are the steps to create a tab: 1. At the command prompt, create a new directory for your tab. -1. Enter the following command in your new directory to start the Microsoft Teams app generator: +1. Enter the following command in the new directory to start the Microsoft Teams app generator: ```cmd yo teams ``` -1. Provide your values to a series of questions prompted by Microsoft Teams app generator to update your `manifest.json` file. +1. Respond to the series of questions prompted by the Microsoft Teams app generator so that the manifest.json file is updated accordingly. :::image type="content" source="~/assets/images/tab-images/teamsTabScreenshot.PNG" alt-text="Teams generator"::: @@ -68,73 +68,73 @@ Following are the steps to create a tab: * **What is your solution name?** - The solution name is your project name. You can accept the suggested name by selecting **Enter**. + The solution name serves as your project name. Developers can accept the suggested name by pressing **Enter**. * **Where do you want to place the files?** - You're in your project directory. Select **Enter**. + Developers confirm they are in the project directory by pressing **Enter**. * **Title of your Microsoft Teams app project?** - The title is your app package name and is used in the app manifest and description. Enter a title or select **Enter** to accept the default name. + The title becomes your app package name and is used in the manifest and description. Either enter a new title or press **Enter** to accept the default. * **Your (company) name? (max 32 characters)** - Your company name is used in the app manifest. Enter a company name or select **Enter** to accept the default name. + The company name appears in the app manifest. Enter a company name or press **Enter** to accept the default. * **Which manifest version would you like to use?** - Select the default schema. + Developers select the default schema. * **Quick scaffolding? (Y/n)** - The default is yes; enter **n** to enter your Microsoft Partner ID. + The default is yes; press **n** to enter your Microsoft Partner ID. * **Enter your Microsoft Partner Id, if you've one? (Leave blank to skip)** - This field isn't required and must be used only if you're already part of the [Microsoft Cloud Partner Program](https://partner.microsoft.com), formerly known as Microsoft Partner Network. + This field is optional and should only be used if already a member of the [Microsoft Cloud Partner Program](https://partner.microsoft.com). * **What do you want to add to your project?** - Select **( * ) A Tab**. + Select **( * ) A Tab**. * **The URL where you will host this solution?** - By default, the generator suggests an Azure website URL. You're only testing your app locally, so a valid URL isn't necessary. + The generator suggests an Azure website URL by default. For local testing, a valid URL is not necessary. - * **Would you like show a loading indicator when your app/tab loads?** + * **Would you like to show a loading indicator when your app/tab loads?** - Choose **not** to include a loading indicator when your app or tab loads. The default is no, enter **n**. + Choose not to include a loading indicator during the app or tab load. The default is no; press **n**. * **Would you like personal apps to be rendered without a tab header-bar?** - Choose **not** to include personal apps to be rendered without a tab header-bar. Default is no, enter **n**. + Choose not to remove the tab header-bar from personal apps. The default is no; press **n**. * **Would you like to include Test framework and initial tests? (y/N)** - Choose **not** to include a test framework for this project. The default is no, enter **n**. + Choose not to include a test framework. The default is no; press **n**. * **Would you like to include ESLint support? (y/N)** - Choose not to include ESLint support. The default is no, enter **n**. + Choose not to include ESLint support. The default is no; press **n**. * **Would you like to use Azure Applications Insights for telemetry? (y/N)** - Choose **not** to include [Azure Application Insights](/azure/azure-monitor/app/app-insights-overview). The default is no; enter **n**. + Choose not to include [Azure Application Insights](/azure/azure-monitor/app/app-insights-overview). The default is no; press **n**. * **Default Tab Name (max 16 characters)?** - Name your tab. This tab name is used throughout your project as a file or URL path component. + Provide a name for the tab. This name is used throughout the project, such as in file names or URL paths. * **What kind of Tab would you like to create?** - Use the arrow keys to select **Personal (static)**. + Using the arrow keys, select **Personal (static)**. * **Do you require Microsoft Entra Single-Sign-On support for the tab?** - Choose **not** to include Microsoft Entra Single-Sign-On support for the tab. The default is yes, enter **n**. + Opt not to include Microsoft Entra Single-Sign-On support. Although the default is yes, press **n**. > [!NOTE] - > In a tab, the tab home page appears only when the user selects the back button (or moves out of the tab) and comes back to the home page. The tab doesn't maintain or retain the previous state by design. + > In a tab, the home page appears only when the user navigates back to it (for instance, by pressing the back button). The tab is designed not to retain the previous state. --> @@ -144,9 +144,9 @@ Following are the steps to create a tab: ### Add a content page to the tab -Create a content page and update the existing files of the tab application: +Developers must create a content page and update the existing files of the tab application as follows: -1. Create a new **personal.html** file in your Visual Studio Code with the following markup: +1. Create a new file named **personal.html** in Visual Studio Code containing the markup: ```html @@ -160,27 +160,27 @@ Create a content page and update the existing files of the tab application: -
-This is your personal tab!
- + +This is your personal tab!
+