updating readmes and changelog - #510
Conversation
There was a problem hiding this comment.
Pull request overview
This PR prepares the Microsoft 365 Agents SDK for Python v1.3.0 release documentation by updating per-package READMEs to point at the new changelog section and by adding the v1.3.0 entry to changelog.md.
Changes:
- Added v1.3.0 release-note links (and, in some packages, expanded release note sections) across multiple library READMEs.
- Updated “Packages Overview” tables to include newly added packages (FastAPI, Slack, Entra auth sidecar) and to prefer the newer Teams package naming.
- Added v1.3.0 release notes content to the root
changelog.md.
Reviewed changes
Copilot reviewed 14 out of 14 changed files in this pull request and generated 15 comments.
Show a summary per file
| File | Description |
|---|---|
| libraries/microsoft-agents-storage-cosmos/readme.md | Adds v1.3.0 release note entry and updates packages list. |
| libraries/microsoft-agents-storage-blob/readme.md | Adds v1.3.0 release note entry and updates packages list. |
| libraries/microsoft-agents-hosting-teams/readme.md | Adds v1.3.0 release note entry and updates packages list. |
| libraries/microsoft-agents-hosting-slack/readme.md | Adds v1.3.0 release notes + packages overview section. |
| libraries/microsoft-agents-hosting-msteams/readme.md | Adds expanded release notes section and Teams Graph factory docs. |
| libraries/microsoft-agents-hosting-fastapi/readme.md | Adds expanded release notes section and packages overview section. |
| libraries/microsoft-agents-hosting-dialogs/readme.md | Moves/expands release notes and adds packages overview section. |
| libraries/microsoft-agents-hosting-core/readme.md | Adds v1.3.0 release note entry and updates packages list. |
| libraries/microsoft-agents-hosting-aiohttp/readme.md | Adds v1.3.0 release note entry and updates packages list. |
| libraries/microsoft-agents-copilotstudio-client/readme.md | Adds v1.3.0 release note entry and updates packages list. |
| libraries/microsoft-agents-authentication-msal/readme.md | Adds v1.3.0 release note entry and updates packages list. |
| libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md | Adds v1.3.0 release note entry + packages overview section. |
| libraries/microsoft-agents-activity/readme.md | Adds v1.3.0 release note entry and updates packages list. |
| changelog.md | Adds v1.3.0 changelog section and Teams package guidance note. |
Comments suppressed due to low confidence (3)
libraries/microsoft-agents-hosting-msteams/readme.md:178
- The Packages Overview lists
microsoft-agents-hosting-msteamsbut omitsmicrosoft-agents-hosting-teams, which still exists as a legacy/back-compat Teams package (per the v1.3.0 changelog). Consider listing it (marked legacy) so users can discover the older package if needed.
| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
libraries/microsoft-agents-hosting-fastapi/readme.md:160
- The Packages Overview table omits
microsoft-agents-hosting-teams, which still exists as a legacy/back-compat Teams hosting package (called out in the v1.3.0 changelog). Consider listing it (marked legacy) alongside...-msteamsto keep this package list accurate.
| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
libraries/microsoft-agents-hosting-slack/readme.md:99
- The Packages Overview table lists
microsoft-agents-hosting-msteamsbut omitsmicrosoft-agents-hosting-teams, which still exists as the legacy/back-compat Teams hosting package (per the v1.3.0 changelog). Consider listing it (marked legacy) to keep this package list complete.
| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 15 out of 15 changed files in this pull request and generated no new comments.
Comments suppressed due to low confidence (3)
libraries/microsoft-agents-hosting-teams/readme.md:125
- This package’s own readme no longer includes
microsoft-agents-hosting-teamsin its “Packages Overview” table, even though the Installation section below tells users topip install microsoft-agents-hosting-teams. Adding an explicit (legacy/back-compat) row avoids confusion and matches the repo-wide changelog guidance.
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
README.md:16
- The README no longer documents the (still-current) Python import namespace change to
microsoft_agents(underscores). There are no remaining references tomicrosoft.agentsin user-facing docs, which makes it easy for users upgrading from older SDKs to get stuck on import errors.
The best way to get started with these packages is to look at the samples available in [https://github.com/microsoft/Agents](https://github.com/microsoft/Agents)
## Packages Overview
README.md:28
- The root package list now omits published packages that are still part of this repo/release:
microsoft-agents-hosting-teams(explicitly described in changelog.md as retained for backward compatibility) andmicrosoft-agents-hosting-slack(library exists with its own readme/pyproject). This makes the top-level README inconsistent with the release notes and other package readmes.
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. | `botbuilder-integration-aiohttp` |
| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures FastAPI to run the Agent. | N/A |
| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. | N/A |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. | `botbuilder-dialogs` |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. | `botbuilder-azure` |
Updates for version release