Skip to content

docs(ms-teams): promote "Enable the Teams channel" to its own step (EN+ZH) - #170

Merged
Nanyan merged 1 commit into
mainfrom
docs/ms-teams-enable-channel-step
Jun 27, 2026
Merged

Nanyan merged 1 commit into
mainfrom
docs/ms-teams-enable-channel-step

Conversation

@FelixLin6

Copy link
Copy Markdown
Contributor

Why

Enabling the Microsoft Teams channel on the Azure Bot was buried as sub-item 5 of "Step 2: Configure the Bot and Note Credentials" — thematically misplaced (Step 2 is about credentials) and easy to skip. Skipping it is the cause of the "Invalid Bot" error when users try to chat, so it deserves to be unmissable.

What

  • Promotes it to its own Step 3: Enable the Microsoft Teams Channel, with a "required and easy to miss" callout and the existing "Invalid Bot" Important note.
  • Renumbers the subsequent Teams-deployment steps accordingly (EN: 3→…→12; ZH: 3→…→11).
  • Updates the cross-references that point into the renumbered range:
    • channels/ms-teams.md: reactions setup "See Step 10" → Step 11 (EN).
    • zh/channels/ms-teams.md: deployment-guide reference 第8步 → 第9步 (preserves the original target through the renumber).

Scope

  • Microsoft Teams entry only (no other channel touched), both EN and ZH guides + their two usage-doc cross-refs. 4 files.

FYI (pre-existing, not changed here)

The bumped ZH reference (zh/channels/ms-teams.md, "未配置 App Catalog ID。请参阅部署指南第9步") points at the Publish step, but App Catalog ID is actually obtained/entered in the Teams Developer Portal / Connect-in-Dashboard steps — a pre-existing mismatch. I only preserved its original target through the renumber rather than guess a re-target; worth correcting in the broader guide rework.

🤖 Generated with Claude Code

…N+ZH)

Enabling the Microsoft Teams channel on the Azure Bot was buried as sub-item 5
of "Step 2: Configure the Bot and Note Credentials" — easy to miss, and the step
most likely to cause the "Invalid Bot" error when skipped. Promote it to its own
"Step 3: Enable the Microsoft Teams Channel" (with a "required and easy to miss"
callout), and renumber the subsequent steps accordingly in both EN and ZH.

Cross-references updated to follow the renumber:
- channels/ms-teams.md: reactions setup "See Step 10" -> "Step 11" (EN).
- zh/channels/ms-teams.md: deployment-guide reference "第8步" -> "第9步" (preserves
  the original target through the renumber).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@Nanyan Nanyan left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clean restructure. Step numbering and cross-references are consistent across all 4 files (EN+ZH deployment guides + troubleshooting tables). The pre-existing ZH cross-ref mismatch (App Catalog ID → Publish step) is noted and reasonably out of scope.

@Nanyan
Nanyan merged commit d89b69e into main Jun 27, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants