Teams SDK and "Tools & SDKs" update

[nickwalkmsft]

First major step towards bringing Teams SDK external docs content into the platform docs.

New pages:

• teams-sdk-overview (preview), the main overview of the SDK. Links to /teams-sdk and /teams-sdk/welcome will eventually redirect here. I would have liked to put this and the other SDK content into a teams-sdk folder, but I can't right now because the external content mirror docset publishes there.
• teams-sdk-programming-model (preview), a technical introduction to the SDK model.
• teams-developer-cli (preview), the main overview of the CLI.
• legacy-tools-sdks (preview), a catch-all for explaining Bot Framework and TeamsFx, among other things, to make up for the removal of dedicated docs about them.

Also:

• Restructures the "Tools & SDKs" section of the TOC to emphasize Teams SDK and CLI and hide legacy content (pages still published, will be redirected and removed or archived later).

[microsoft-production-github-app]

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/legacy-tools-sdks.md	89	1	link	✅
msteams-platform/teams-sdk-overview.md	93	4	link	✅
msteams-platform/teams-sdk-programming-model.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]

Learn Build status updates of commit f296957:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/legacy-tools-sdks.md	⚠️Warning	View	Details
msteams-platform/teams-sdk-programming-model.md	💡Suggestion	View	Details
msteams-platform/teams-sdk-overview.md	✅Succeeded	View
msteams-platform/TOC.yml	✅Succeeded	View

msteams-platform/legacy-tools-sdks.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 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.
• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'legacy-tools-sdks.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

msteams-platform/teams-sdk-programming-model.md

• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'legacy-tools-sdks.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

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]

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]

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/legacy-tools-sdks.md	89	1	link	✅
msteams-platform/teams-developer-cli.md	100	1	link	✅
msteams-platform/teams-sdk-overview.md	92	3	link	✅
msteams-platform/teams-sdk-programming-model.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]

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]

Learn Build status updates of commit a5d5c04:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/legacy-tools-sdks.md	⚠️Warning	View	Details
msteams-platform/teams-developer-cli.md	💡Suggestion	View	Details
msteams-platform/teams-sdk-programming-model.md	💡Suggestion	View	Details
msteams-platform/teams-sdk-overview.md	✅Succeeded	View
msteams-platform/TOC.yml	✅Succeeded	View

msteams-platform/legacy-tools-sdks.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 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.
• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'legacy-tools-sdks.md(3,14)', 'teams-developer-cli.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

msteams-platform/teams-developer-cli.md

• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'legacy-tools-sdks.md(3,14)', 'teams-developer-cli.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

msteams-platform/teams-sdk-programming-model.md

• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'legacy-tools-sdks.md(3,14)', 'teams-developer-cli.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

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]

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/legacy-tools-sdks.md	84	8	link	✅
msteams-platform/teams-developer-cli.md	100	1	link	✅
msteams-platform/teams-sdk-overview.md	94	2	link	✅
msteams-platform/teams-sdk-programming-model.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]

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]

Learn Build status updates of commit 0ba574f:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/legacy-tools-sdks.md	⚠️Warning	View	Details
msteams-platform/teams-developer-cli.md	💡Suggestion	View	Details
msteams-platform/teams-sdk-programming-model.md	💡Suggestion	View	Details
msteams-platform/teams-sdk-overview.md	✅Succeeded	View
msteams-platform/TOC.yml	✅Succeeded	View

msteams-platform/legacy-tools-sdks.md

• Line 26, Column 6: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/bot-service/bot-service-overview' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
• Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.
• Line 26, Column 6: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/bot-service/bot-service-overview' will be broken in isolated environments. Replace with a relative link.

msteams-platform/teams-developer-cli.md

• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'teams-developer-cli.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

msteams-platform/teams-sdk-programming-model.md

• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'teams-developer-cli.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

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]

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]

Learn Build status updates of commit d841d74:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
msteams-platform/concepts/teams-application-model.md	⚠️Warning	View	Details
msteams-platform/legacy-tools-sdks.md	💡Suggestion	View	Details
msteams-platform/teams-developer-cli.md	💡Suggestion	View	Details
msteams-platform/teams-sdk-programming-model.md	💡Suggestion	View	Details
msteams-platform/teams-sdk-overview.md	✅Succeeded	View
msteams-platform/TOC.yml	✅Succeeded	View

msteams-platform/concepts/teams-application-model.md

• Line 5, Column 11: [Warning: ms-topic-invalid - See documentation] Invalid value for 'ms.topic': 'conceptual'.

msteams-platform/legacy-tools-sdks.md

• Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

msteams-platform/teams-developer-cli.md

• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'teams-developer-cli.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

msteams-platform/teams-sdk-programming-model.md

• Line 3, Column 14: [Suggestion: duplicate-descriptions - See documentation] Attribute 'description' with value 'TODO' is duplicated in 'teams-developer-cli.md(3,14)', 'teams-sdk-programming-model.md(3,14)'.

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.