Accessibility guidelines by SuzanneTocco · Pull Request #14379 · MicrosoftDocs/msteams-docs

SuzanneTocco · 2026-05-28T17:56:05Z

⭐ 🖼️ MS LEARN PREVIEW LINK:

https://review.learn.microsoft.com/en-us/microsoftteams/platform/html-widgets/accessibility-guidelines?branch=pr-en-us-14379

…ines HTML widgets accessibility starter content

name change

microsoft-production-github-app · 2026-05-28T17:56:20Z

Acrolinx Scorecards

We 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:

Article	Score	Issues	Scorecard	Processed
msteams-platform/TOC.yml	92	25	link	✅
msteams-platform/html-widgets/accessibility-guidelines.md	80	21	link	✅
msteams-platform/html-widgets/overview.md	100	0	link	✅
msteams-platform/html-widgets/user-experience-guidelines.md	100	0	link	✅

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.

learn-build-service-prod · 2026-05-28T17:57:24Z

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

text

microsoft-production-github-app · 2026-05-28T18:00:04Z

Acrolinx Scorecards

We 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:

Article	Score	Issues	Scorecard	Processed
msteams-platform/TOC.yml	92	25	link	✅
msteams-platform/html-widgets/accessibility-guidelines.md	80	21	link	✅
msteams-platform/html-widgets/overview.md	100	0	link	✅
msteams-platform/html-widgets/user-experience-guidelines.md	100	0	link	✅

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.

learn-build-service-prod · 2026-05-28T18:01:44Z

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-05-28T18:02:21Z

Learn Build status updates of commit 169e964:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/overview.md	⚠️Warning	View	Details
msteams-platform/html-widgets/user-experience-guidelines.md	⚠️Warning	View	Details
msteams-platform/TOC.yml	⚠️Warning	View	Details

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Accessibility guidelines for HTML widgets in Microsoft Teams'.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/overview.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/user-experience-guidelines.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/TOC.yml

Line 883, Column 13: [Warning: file-not-found - See documentation] Invalid file link: 'html-widgets/integrate-web-apps-overview.md'.

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.

learn-build-service-prod · 2026-05-28T18:04:21Z

Learn Build status updates of commit 91c7bc1:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/overview.md	⚠️Warning	View	Details
msteams-platform/html-widgets/user-experience-guidelines.md	⚠️Warning	View	Details
msteams-platform/TOC.yml	⚠️Warning	View	Details

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Accessibility guidelines for HTML widgets in Microsoft Teams 365'.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/overview.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/user-experience-guidelines.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/TOC.yml

Line 883, Column 13: [Warning: file-not-found - See documentation] Invalid file link: 'html-widgets/integrate-web-apps-overview.md'.

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.

nickwalkmsft · 2026-05-28T18:24:22Z

@SuzanneTocco I'm just leaving you a message in the collaboration space of this PR so you can see what it looks like and what kind of notifications you get.

microsoft-production-github-app · 2026-05-29T17:42:50Z

Acrolinx Scorecards

We 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:

Article	Score	Issues	Scorecard	Processed
msteams-platform/TOC.yml	92	25	link	✅
msteams-platform/html-widgets/accessibility-guidelines.md	80	21	link	✅
msteams-platform/html-widgets/overview.md	100	0	link	✅
msteams-platform/html-widgets/user-experience-guidelines.md	100	0	link	✅

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.

learn-build-service-prod · 2026-05-29T17:44:29Z

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

microsoft-production-github-app · 2026-05-29T17:45:28Z

Acrolinx Scorecards

We 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:

Article	Score	Issues	Scorecard	Processed
msteams-platform/TOC.yml	92	25	link	✅
msteams-platform/html-widgets/accessibility-guidelines.md	79	22	link	✅
msteams-platform/html-widgets/overview.md	100	0	link	✅
msteams-platform/html-widgets/user-experience-guidelines.md	100	0	link	✅

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.

learn-build-service-prod · 2026-05-29T17:47:06Z

Learn Build status updates of commit 85a9ecc:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/overview.md	⚠️Warning	View	Details
msteams-platform/html-widgets/user-experience-guidelines.md	⚠️Warning	View	Details
msteams-platform/TOC.yml	⚠️Warning	View	Details

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Accessibility guidelines for HTML widgets in Microsoft Teams 365'.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/overview.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/user-experience-guidelines.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/TOC.yml

Line 886, Column 13: [Warning: file-not-found - See documentation] Invalid file link: 'html-widgets/integrate-web-apps-overview.md'.

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.

learn-build-service-prod · 2026-05-29T17:47:28Z

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

microsoft-production-github-app · 2026-05-29T19:06:15Z

Acrolinx Scorecards

We 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:

Article	Score	Issues	Scorecard	Processed
msteams-platform/TOC.yml	92	25	link	✅
msteams-platform/html-widgets/accessibility-guidelines.md	77	27	link	✅
msteams-platform/html-widgets/overview.md	100	0	link	✅
msteams-platform/html-widgets/user-experience-guidelines.md	100	0	link	✅

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.

learn-build-service-prod · 2026-05-29T19:07:58Z

Learn Build status updates of commit 1092f24:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/overview.md	⚠️Warning	View	Details
msteams-platform/html-widgets/user-experience-guidelines.md	⚠️Warning	View	Details
msteams-platform/TOC.yml	⚠️Warning	View	Details

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Accessibility guidelines for HTML widgets in Microsoft Teams 365'.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/overview.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/user-experience-guidelines.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/TOC.yml

Line 886, Column 13: [Warning: file-not-found - See documentation] Invalid file link: 'html-widgets/integrate-web-apps-overview.md'.

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.

learn-build-service-prod · 2026-05-29T19:13:46Z

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

microsoft-production-github-app · 2026-05-29T19:30:07Z

Acrolinx Scorecards

We 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:

Article	Score	Issues	Scorecard	Processed
msteams-platform/TOC.yml	92	25	link	✅
msteams-platform/html-widgets/accessibility-guidelines.md	79	29	link	✅
msteams-platform/html-widgets/overview.md	100	0	link	✅
msteams-platform/html-widgets/user-experience-guidelines.md	100	0	link	✅

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.

learn-build-service-prod · 2026-05-29T19:33:54Z

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-05-29T19:35:24Z

Learn Build status updates of commit 0dccf8b:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/overview.md	⚠️Warning	View	Details
msteams-platform/html-widgets/user-experience-guidelines.md	⚠️Warning	View	Details
msteams-platform/TOC.yml	⚠️Warning	View	Details

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Accessibility guidelines for HTML widgets in Microsoft Teams 365'.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/overview.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/user-experience-guidelines.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/TOC.yml

Line 886, Column 13: [Warning: file-not-found - See documentation] Invalid file link: 'html-widgets/integrate-web-apps-overview.md'.

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.

microsoft-production-github-app · 2026-05-29T21:24:10Z

Acrolinx Scorecards

We 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:

Article	Score	Issues	Scorecard	Processed
msteams-platform/TOC.yml	92	25	link	✅
msteams-platform/html-widgets/accessibility-guidelines.md	80	35	link	✅
msteams-platform/html-widgets/overview.md	100	0	link	✅
msteams-platform/html-widgets/user-experience-guidelines.md	100	0	link	✅

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.

learn-build-service-prod · 2026-05-29T21:25:28Z

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-05-29T21:26:56Z

Learn Build status updates of commit 40e1fee:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/overview.md	⚠️Warning	View	Details
msteams-platform/html-widgets/user-experience-guidelines.md	⚠️Warning	View	Details
msteams-platform/TOC.yml	⚠️Warning	View	Details

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 11, Column 1: [Warning: h1-not-first - See documentation] Markdown content is not allowed before H1 'Accessibility guidelines for HTML widgets in Microsoft Teams 365'.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/overview.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/html-widgets/user-experience-guidelines.md

Line 0, Column 0: [Warning: h1-missing - See documentation] H1 is required. Use a single hash (#) followed by a space to create your top-level heading.
Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'TODO - Teams' is duplicated in: 'html-widgets/overview.md(2,8), html-widgets/user-experience-guidelines.md(2,8)'. Titles must be unique within a docset.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)', 'html-widgets/user-experience-guidelines.md(4,14)'.

msteams-platform/TOC.yml

Line 886, Column 13: [Warning: file-not-found - See documentation] Invalid file link: 'html-widgets/integrate-web-apps-overview.md'.

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.

learn-build-service-prod · 2026-07-10T21:06:23Z

Learn Build status updates of commit 7db53e2:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/icon_colorBrush.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:06:27Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves quickly with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

2	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in the sense of helping users position or familiarize themselves with the widget, not as a reference to a geographic region. According to the rule, when used in non-geographical contexts such as to refer to positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Restored the title, author, and metadata for the accessibility guidelines document. Added a new section on recommended best practices for accessibility in HTML widgets.

learn-build-service-prod · 2026-07-10T21:08:20Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in the sense of helping users position or familiarize themselves with the widget, not as a reference to a geographic region. According to the rule, when used in non-geographical contexts such as to refer to positioning, the term should be left unchanged.

2	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves quickly with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-07-10T21:08:39Z

Learn Build status updates of commit ca404c7:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/icon_colorBrush.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:11:37Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in the sense of helping users position or familiarize themselves with the widget, not as a reference to a geographic region. According to the rule, when used in non-geographical contexts such as to refer to positioning, the term should be left unchanged.

2	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves quickly with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-07-10T21:11:44Z

Learn Build status updates of commit d67a764:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 38, Column 169: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.
Line 38, Column 169: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' will be broken in isolated environments. Replace with a relative link.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:17:13Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves with a widget, not as a reference to a geographic region. According to the rule, when used in non-geographical contexts such as to refer to positioning, the term should be left unchanged.

2	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in a non-geographical context, referring to helping users position or familiarize themselves quickly with widget elements. According to the rule, it should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-07-10T21:18:46Z

Learn Build status updates of commit 445e627:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 38, Column 169: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.
Line 38, Column 169: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' will be broken in isolated environments. Replace with a relative link.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:21:50Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in the sense of helping users position or familiarize themselves with the widget, not as a reference to a geographic region. According to the rule, when used in non-geographical contexts such as to refer to positioning, the term should be left unchanged.

2	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves quickly with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-07-10T21:21:52Z

Learn Build status updates of commit 7a2c1de:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 38, Column 169: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.
Line 38, Column 169: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' will be broken in isolated environments. Replace with a relative link.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:32:42Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in a non-geographical context, referring to helping users position or familiarize themselves quickly with widget elements. According to the rule, it should be left unchanged.

2	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves with the widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-07-10T21:33:21Z

Learn Build status updates of commit 3301f23:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 71, Column 169: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.
Line 71, Column 169: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' will be broken in isolated environments. Replace with a relative link.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:40:44Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in a non-geographical context, referring to helping users position or familiarize themselves quickly with a widget. According to the rule, it should be left unchanged.

2	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves quickly with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-07-10T21:41:10Z

Learn Build status updates of commit 1fc753a:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 71, Column 169: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.
Line 71, Column 169: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' will be broken in isolated environments. Replace with a relative link.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:43:00Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users quickly position or familiarize themselves with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

2	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves quickly with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-07-10T21:43:40Z

Learn Build status updates of commit c480eb9:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 71, Column 169: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.
Line 71, Column 169: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' will be broken in isolated environments. Replace with a relative link.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:43:53Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the sense of helping users position or familiarize themselves quickly, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as to refer to positioning, the term should be left unchanged.

2	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users quickly position or familiarize themselves with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-07-10T21:45:17Z

Learn Build status updates of commit 23fffca:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 71, Column 169: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.
Line 71, Column 169: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' will be broken in isolated environments. Replace with a relative link.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:49:15Z

Learn Build status updates of commit 0f7d18e:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/html-widgets/accessibility-guidelines.md	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderRadiusStyles.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/borderShapeExamples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/cardAnatomy.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_default.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_emphasis.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_gallery.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_good.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/container_warning.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/expanded_surface.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_colorBrush.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_icon.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_shapes.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_spacing.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon_text.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-arrowUp.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/icon-magnifyingGlass.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/input_examples.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/progressiveDisclosure.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_accent.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_attention.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_dark.png	⚠️Warning	View	Details
msteams-platform/html-widgets/images/textColor_default.png	⚠️Warning	View	Details

This comment lists only the first 25 files in the pull request.

msteams-platform/html-widgets/accessibility-guidelines.md

Line 3, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'Suzanne Tocco' is not a valid GitHub ID.
Line 71, Column 169: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
Line 4, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'html-widgets/accessibility-guidelines.md(4,14)', 'html-widgets/overview.md(4,14)'.
Line 71, Column 169: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/appsource/publish' will be broken in isolated environments. Replace with a relative link.

msteams-platform/html-widgets/images/borderRadiusStyles.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/borderShapeExamples.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/cardAnatomy.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_accent.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_attention.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_default.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_emphasis.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_gallery.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_good.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/container_warning.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.
Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/html-widgets/images/expanded_surface.png

Line 0, Column 0: [Warning: image-name-invalid-character - See documentation] Only lowercase letters, numbers, and hyphens are allowed in image names.

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.

learn-build-service-prod · 2026-07-10T21:51:02Z

PoliCheck Scan Report

The 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.

#	File	Term	Line	Sev	AI Recommendation	Class	AI Review Details
1	msteams-platform\html-widgets\playground.md	Orient	91	2	No action needed	Geopolitical	Details The term `Orient` is used in the context of helping users position or familiarize themselves quickly with a widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as positioning, the term should be left unchanged.

2	msteams-platform\html-widgets\ux-guidelines.md	Orient	124	2	No action needed	Geopolitical	Details The term `Orient` is used in the sense of helping users position or familiarize themselves with the widget, not as a reference to a geographic region. According to the rules, when used in non-geographical contexts such as to refer to positioning, the term should be left unchanged.

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

nickwalkmsft and others added 3 commits May 27, 2026 16:15

HTML widgets accessibility starter content

d9c4d9c

Merge pull request #1 from nickwalkmsft/nickwalk-accessibility-guidel…

e2ae369

…ines HTML widgets accessibility starter content

Update accessibility-guidelines.md

169e964

name change

Update accessibility-guidelines.md

91c7bc1

text

Update accessibility-guidelines.md

85a9ecc

Update accessibility-guidelines.md

b7311d6

More content

1092f24

Update accessibility-guidelines.md

0dccf8b

Update accessibility-guidelines.md

40e1fee

Update accessibility guidelines for HTML widgets

7db53e2

Restore metadata and add best practices section

ca404c7

Restored the title, author, and metadata for the accessibility guidelines document. Added a new section on recommended best practices for accessibility in HTML widgets.

Update accessibility-guidelines.md

d67a764

Update accessibility-guidelines.md

445e627

Update accessibility-guidelines.md

7a2c1de

Update accessibility-guidelines.md

3301f23

Update section title from 'Required' to 'Widget requirements'

1fc753a

SuzanneTocco added 2 commits July 10, 2026 14:42

Update ux-guidelines.md

c480eb9

Clarify submission requirements for Teams Store

23fffca

Update ux-guidelines.md

0f7d18e

Uh oh!

Conversation

SuzanneTocco commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⭐ 🖼️ MS LEARN PREVIEW LINK:

Uh oh!

microsoft-production-github-app Bot commented May 28, 2026

Acrolinx Scorecards

Uh oh!

learn-build-service-prod Bot commented May 28, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

microsoft-production-github-app Bot commented May 28, 2026

Acrolinx Scorecards

Uh oh!

learn-build-service-prod Bot commented May 28, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented May 28, 2026

⚠️ Validation status: warnings

Uh oh!

learn-build-service-prod Bot commented May 28, 2026

⚠️ Validation status: warnings

Uh oh!

nickwalkmsft commented May 28, 2026

Uh oh!

microsoft-production-github-app Bot commented May 29, 2026

Acrolinx Scorecards

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

microsoft-production-github-app Bot commented May 29, 2026

Acrolinx Scorecards

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

⚠️ Validation status: warnings

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

microsoft-production-github-app Bot commented May 29, 2026

Acrolinx Scorecards

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

⚠️ Validation status: warnings

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

microsoft-production-github-app Bot commented May 29, 2026

Acrolinx Scorecards

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

⚠️ Validation status: warnings

Uh oh!

microsoft-production-github-app Bot commented May 29, 2026

Acrolinx Scorecards

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented May 29, 2026

SuzanneTocco commented May 28, 2026 •

edited

Loading