Skip to content

docs(channel-deployment): rewrite EN Microsoft Teams tutorial with 47 annotated screenshots - #177

Merged
tyler-0xffff merged 1 commit into
openmaxai:mainfrom
Eriche985:docs/msteams-en-tutorial-rewrite
Jul 17, 2026
Merged

tyler-0xffff merged 1 commit into
openmaxai:mainfrom
Eriche985:docs/msteams-en-tutorial-rewrite

Conversation

@Eriche985

Copy link
Copy Markdown
Contributor

Summary

Full rewrite of Option G: Microsoft Teams Deployment on the EN channel-deployment page, based on a verified end-to-end deployment run. Scope is the Teams section only — no other sections touched.

What changed

  • 47 annotated screenshots (docs/public/msteams-s*.png) covering all 11 steps: Azure Bot creation, messaging endpoint + credentials, Teams channel enablement, client secret, Graph API permissions + admin consent, Teams Developer Portal app, manifest configuration, branding, org publish + admin approval, Dashboard connect, first chat.
  • New "Before You Start" section: Entra tenant / Azure subscription prerequisites, with a zero-cost explanation for the F0 tier (common customer concern).
  • "Credentials You Will Collect" table up front — App ID, Tenant ID, App Password (secret Value), App Catalog ID — each step then points back to it.
  • Kept from the previous version: Redirect URI subsection for reactions, one-time reactions sign-in note, sideload alternative for orgs without admin approval; FAQ table updated to match the new step numbering.
  • Manifest JSON and Graph permission JSON verified against a working deployment (9 permission entries).

Notes for review

  • Screenshot naming follows the existing whatsapp-*/lark-* convention in docs/public/; images are 2880px PNGs like the existing WhatsApp EN set, embedded with the same withBase img pattern.
  • Section anchor {#ms-teams} and Option G lettering unchanged, so existing links keep working.
  • vitepress build passes; all 47 images verified present in the rendered page.

🤖 Generated with Claude Code

…notated screenshots

Full rewrite of Option G based on a verified end-to-end deployment:
- 47 annotated screenshots covering all 11 steps (Azure Bot, Graph
  permissions, Teams Developer Portal, publish & approval, Dashboard
  connect, first chat)
- New 'Before You Start' section: tenant/subscription prerequisites,
  zero-cost explanation for the F0 tier
- Step-by-step credential collection table (App ID, Tenant ID,
  App Password, App Catalog ID)
- Kept: Redirect URI for reactions, one-time reactions sign-in,
  sideload alternative; FAQ updated to match new step numbering

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@tyler-0xffff tyler-0xffff 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.

Approve ✅ 内容已在群里逐条核对(Azure 订阅要求、47 张截图一一对应、品牌迁移干净、步骤交叉引用一致)。三条小建议非阻塞,按 Eriche 指示合并部署。

@tyler-0xffff
tyler-0xffff merged commit 2295a3c into openmaxai:main Jul 17, 2026
3 checks passed
tyler-0xffff pushed a commit that referenced this pull request Jul 17, 2026
…to -v2) (#178)

Some edge nodes cached 404s for the msteams-s*.png URLs during the #177
deploy window (HTML propagated before assets; 404s cached up to
max-age=14400), leaving broken figures for some viewers. Renaming all 47
images with a -v2 suffix gives every URL a fresh cache key. No content
changes — pure rename + reference update.

Co-authored-by: Eriche985 <eriche985@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
tyler-0xffff pushed a commit that referenced this pull request Jul 23, 2026
…annotated Chinese-UI screenshots (#183)

Aligns the ZH Teams tutorial (选项H, anchor #ms-teams unchanged) with the
rewritten EN version (#177): adds 开始之前 prerequisites and credentials
table, full step-by-step walkthrough using Chinese Azure/Teams portal
screenshots, and an updated FAQ. Step order follows the reviewed ZH flow:
第9步 Dashboard 连接, 第10步 发布并开始聊天 (10 steps vs EN 11).

Co-authored-by: Eriche985 <eriche985@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
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