Suggestions for new message format guidance article#14473
Conversation
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 878c726: ✅ Validation status: passed
For more details, please refer to the build report. |
| **Use for:** | ||
| - "What time is the team sync?" → "Your team sync is at 2 PM Pacific today." | ||
|
|
||
| - Simple answers to questions: "Your team sync is at 2 PM Pacific today." |
There was a problem hiding this comment.
The scenario: example structure is good, see if you can make that parallel all the way down.
| @@ -78,10 +86,7 @@ Use for rich, stateful, interactive experiences beyond what a card can offer — | |||
|
|
|||
| **Avoid when:** The experience fits in a card (use Adaptive Cards instead), or the UI is too rich to belong in a Teams message at all — a full analytics suite, an interactive CAD viewer, or any app-scale UI should live on the web and be linked to, not embedded. Widgets occupy the middle ground: richer than a card, scoped enough to feel native, but they do not replace the rich experience of a full app. Widgets have higher latency, require extra infrastructure, and have limited support on mobile / classic Teams. Default to Adaptive Cards; escalate to Widget only when cards hit a hard ceiling. | |||
There was a problem hiding this comment.
Consider moving some of this to the paragraph right under the heading.
| - name: Format the bot messages | ||
| href: bots/how-to/format-your-bot-messages.md | ||
| displayName: cross-platform support | ||
| - name: Format the bot messages |
There was a problem hiding this comment.
This is just the most appropriate place for this currently. Soon most everything here is going to move up to the "agents" section that is much more prominently placed in the overall TOC.
1 participant
A few editorial suggestions, TOC inclusion, and metadata