Skip to content

Python: Docs: Add Microsoft Agent Framework successor callout to READMEs#13932

Merged
moonbox3 merged 2 commits into
microsoft:mainfrom
moonbox3:docs/maf-successor-callout
Apr 30, 2026
Merged

Python: Docs: Add Microsoft Agent Framework successor callout to READMEs#13932
moonbox3 merged 2 commits into
microsoft:mainfrom
moonbox3:docs/maf-successor-callout

Conversation

@moonbox3

Copy link
Copy Markdown
Collaborator

Motivation and Context

Now that Microsoft Agent Framework (MAF) is the successor SDK to Semantic Kernel, the top-level and per-language READMEs should direct community members — especially newcomers landing here from search, GitHub, PyPI, or NuGet — to MAF for new work, and clearly state SK's ongoing maintenance posture.

Description

Adds a prominent GitHub > [!IMPORTANT] callout, placed directly under the existing title/badges block, to:

  • README.md (top-level)
  • python/README.md
  • dotnet/README.md

Each callout:

  • Names MAF as Semantic Kernel's successor SDK and links to https://github.com/microsoft/agent-framework.
  • Describes MAF as "an open, multi-language framework for building production-grade AI agents and multi-agent workflows in .NET and Python".
  • Asks readers to use MAF for the latest abstractions to build agents, workflows, and multi-agent orchestrations.
  • States that Semantic Kernel will continue to receive minimal security and bug fixes only.

No other README content is modified; SK identity, badges, install steps, and quickstart samples are preserved.

Contribution Checklist

  • The code builds clean without any errors or warnings — docs-only change.
  • I didn't break anyone — additive callout only.
  • All relevant CONTRIBUTING.md sections were followed.

Add a prominent "IMPORTANT" callout to the top-level, Python, and .NET
READMEs directing readers to Microsoft Agent Framework (MAF) as
Semantic Kernel's successor SDK, and noting that SK will continue to
receive minimal security and bug fixes only.
Copilot AI review requested due to automatic review settings April 29, 2026 09:59
@moonbox3 moonbox3 requested review from a team as code owners April 29, 2026 09:59
@moonbox3 moonbox3 added .NET Issue or Pull requests regarding .NET code python Pull requests for the Python Semantic Kernel documentation labels Apr 29, 2026
@github-actions github-actions Bot changed the title Docs: Add Microsoft Agent Framework successor callout to READMEs .Net: Docs: Add Microsoft Agent Framework successor callout to READMEs Apr 29, 2026
@github-actions github-actions Bot changed the title .Net: Docs: Add Microsoft Agent Framework successor callout to READMEs Python: Docs: Add Microsoft Agent Framework successor callout to READMEs Apr 29, 2026

@github-actions github-actions Bot 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.

Automated Code Review

Reviewers: 4 | Confidence: 73% | Result: All clear

Reviewed: Correctness, Security Reliability, Test Coverage, Design Approach


Automated review by moonbox3's agents

Copilot AI 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.

Pull request overview

Adds prominent “IMPORTANT” callouts to the repo’s primary READMEs to direct new users to Microsoft Agent Framework (MAF) as the successor SDK and clarify Semantic Kernel’s maintenance posture.

Changes:

  • Inserted a GitHub admonition (> [!IMPORTANT]) callout under the title/badges in the top-level README.
  • Added the same successor/maintenance callout to the Python README.
  • Added the same successor/maintenance callout to the .NET README.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
README.md Adds a top-level “IMPORTANT” callout pointing users to MAF as the successor SDK.
python/README.md Adds the same callout for Python users (also impacts PyPI rendering).
dotnet/README.md Adds the same callout for .NET users (GitHub-facing README).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread python/README.md Outdated
Comment thread README.md Outdated
@moonbox3 moonbox3 enabled auto-merge April 30, 2026 05:52
@moonbox3 moonbox3 disabled auto-merge April 30, 2026 06:16
@moonbox3 moonbox3 merged commit ea9981f into microsoft:main Apr 30, 2026
34 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation .NET Issue or Pull requests regarding .NET code python Pull requests for the Python Semantic Kernel

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants