[Dev-Docs AI Improvement]: Manage your apps in Developer Portal #13667
Conversation
…eveloper-portal.md by yashy797
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 8517689:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| msteams-platform/concepts/build-and-test/manage-your-apps-in-developer-portal.md | View | Details |
msteams-platform/concepts/build-and-test/manage-your-apps-in-developer-portal.md
- Line 1, Column 1: [Warning: title-missing - See documentation]
Missing required attribute: 'title'. Add a title string to show in search engine results. - Line 1, Column 1: [Warning: ms-topic-missing - See documentation]
Missing required attribute: 'ms.topic'. - Line 17, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/dashboard-page_1.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 26, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/configure.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 44, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/package-editor.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 46, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/app-package-editor-update.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 124, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/app-validation-home-get-started.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 193, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/tools-in-dev-portal_1.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 197, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/Add_new_bot.PNG' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 227, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/list-agent-blueprint.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 239, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/agent-blueprint.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 242, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/new-agent-blueprint.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 245, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/create-new-agent-blueprint.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 255, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/basic-information-agent-blueprint.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 271, Column 1: [Warning: hard-coded-locale - See documentation]
Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/configuration-agent-blueprint.png' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites. - Line 1, Column 1: [Suggestion: ms-date-missing - See documentation]
Missing required attribute: 'ms.date'. - Line 1, Column 1: [Suggestion: description-missing - See documentation]
Missing required attribute: 'description'. - Line 17, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/dashboard-page_1.png' will be broken in isolated environments. Replace with a relative link. - Line 26, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/configure.png' will be broken in isolated environments. Replace with a relative link. - Line 44, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/package-editor.png' will be broken in isolated environments. Replace with a relative link. - Line 46, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/app-package-editor-update.png' will be broken in isolated environments. Replace with a relative link. - Line 124, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/app-validation-home-get-started.png' will be broken in isolated environments. Replace with a relative link. - Line 193, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/tools-in-dev-portal_1.png' will be broken in isolated environments. Replace with a relative link. - Line 197, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/Add_new_bot.PNG' will be broken in isolated environments. Replace with a relative link. - Line 227, Column 1: [Suggestion: docs-link-absolute - See documentation]
Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/assets/images/tdp/list-agent-blueprint.png' will be broken in isolated environments. Replace with a relative link.
This comment lists only the first 25 errors (including error/warning/suggestion) in the pull request.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
| @@ -1,42 +1,31 @@ | |||
| --- | |||
There was a problem hiding this comment.
These are mandatory elements. Do not delete
|
|
||
| # Manage your apps in Developer Portal | ||
|
|
||
| After you upload your app in Microsoft Teams, you can manage your app in Developer Portal. The article provides comprehensive guidance on app configuration, analytics, and validation to enhance the Teams app experience.<br> |
There was a problem hiding this comment.
Please retain original version as it is more consistent with Microsoft Writing Style Guide principles. The reworked version is less consistent - “to enhance Teams app experience”
This feels grammatically incomplete, because “Teams app experience” functions as a defined noun phrase and normally requires an article: the Teams app experience.
| * **Active users (Preview)**: Shows you the active user count. | ||
| * **Basic information**: Shows you the **App ID**, **Version**, **Manifest version**, and other basic information. | ||
|
|
||
| :::image type="content" source="../../assets/images/tdp/dashboard-page_1.png" alt-text="The screenshot is an example that shows the Overview page of the app you created in Developer Portal." lightbox="../../assets/images/tdp/dashboard-page_1.PNG"::: |
There was a problem hiding this comment.
Do not change the image path. This is for all images
| * **Single sign-on**: Bot registered on Microsoft Entra ID supports single sign-on (SSO). If a bot is registered on Bot Framework portal (or within Developer Portal under **Bot management**), then a bot doesn't support SSO, and you have to register your bot on Microsoft Entra ID to support SSO. For a bot registered on Microsoft Entra ID, add the **Application ID URI**. To get **Application ID URI** from Microsoft Entra ID, see [how to use SSO authentication for bots](../../bots/how-to/authentication/auth-aad-sso-bots.md). | ||
| * **Languages**: This section allows you to set up or change the language of your app. | ||
| * **Domain**: This section allows you to add the domains to load your apps in the Teams client, such as *.example.com. | ||
| * **Domain**: This section allows you to add the domains to load your apps in Teams client, such as *.example.com. |
There was a problem hiding this comment.
Please edit this to This section allows you to add the domains required to load your apps...
|
|
||
| ## Use tools to create app features | ||
|
|
||
| The Developer Portal also includes tools to help you build key features of Teams apps. The following are the tools: |
There was a problem hiding this comment.
Add “the” before Developer Portal because it refers to it specifically in this context
|
|
||
| #### View and use existing Agent Identity Blueprints | ||
|
|
||
| The Agent Identity Blueprint tool in the Developer Portal displays a list of existing blueprints available in your tenant. |
There was a problem hiding this comment.
Retain the original. As in full sentences, MSTP prefers the definite article when referring to a specific product/portal.
Reads more natural and complete than a sentence starting without an article.
This PR updates the content of the file: msteams-platform/concepts/build-and-test/manage-your-apps-in-developer-portal.md.
Submitted by: @yashy797