Shell (.NET 11): document Android handler architecture

[jfversluis]

Summary

• Updates the handler table to show Android Shell uses ShellHandler in .NET MAUI 11, while iOS/Mac Catalyst continue to use ShellRenderer.
• Adds a Shell overview note for the Android handler architecture and explicit legacy renderer opt-out.
• Adds focused migration guidance for custom Android Shell renderer subclasses.

Verification

• Verified against dotnet/maui Preview 6 source and upstream PR: [net11.0][Android] Implement handler based Shell architecture replacing legacy renderers maui#34758
• Checked markdown diff and moniker block balance for changed pages.
• Ran git diff --check.

Files changed

• docs/user-interface/handlers/index.md
• docs/fundamentals/shell/index.md
• docs/migration/custom-renderers.md

---

Internal previews

📄 File	🔗 Preview link
docs/fundamentals/shell/index.md	docs/fundamentals/shell/index
docs/migration/custom-renderers.md	docs/migration/custom-renderers
docs/user-interface/handlers/index.md	docs/user-interface/handlers/index

[learn-build-service-prod]

Learn Build status updates of commit 0f0eadb:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/fundamentals/shell/index.md	✅Succeeded	View (>=net-maui-8.0)
docs/migration/custom-renderers.md	✅Succeeded	View (>=net-maui-8.0)
docs/user-interface/handlers/index.md	✅Succeeded	View (>=net-maui-8.0)

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[Copilot]

Pull request overview

Documents the updated .NET MAUI 11 Shell implementation details by clarifying that Android Shell now defaults to a handler-based architecture (while iOS/Mac Catalyst remain renderer-based), and adds migration guidance for apps that previously customized Android Shell via renderer subclasses.

Changes:

• Splits the page handler table by moniker to reflect Android’s switch to ShellHandler starting in .NET MAUI 11.
• Adds a Shell overview note describing Android’s handler-based Shell architecture and how to explicitly opt into the legacy compatibility renderer.
• Adds migration guidance mapping common Android Shell renderer customizations to the corresponding handler customization points.

Show a summary per file

File	Description
docs/user-interface/handlers/index.md	Updates the page implementation table with <=10 vs >=11 monikered rows and adds an Android Shell handler note for .NET MAUI 11.
docs/fundamentals/shell/index.md	Adds a .NET MAUI 11+ section documenting Android Shell’s handler-based architecture and explicit compatibility renderer opt-out.
docs/migration/custom-renderers.md	Adds .NET MAUI 11+ migration guidance mapping Android Shell renderer customizations to handler equivalents, including an opt-in legacy renderer snippet.

Copilot's findings

• Files reviewed: 3/3 changed files
• Comments generated: 1

[learn-build-service-prod]

Learn Build status updates of commit 0a954c6:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/fundamentals/shell/index.md	✅Succeeded	View (>=net-maui-8.0)
docs/migration/custom-renderers.md	✅Succeeded	View (>=net-maui-8.0)
docs/user-interface/handlers/index.md	✅Succeeded	View (>=net-maui-8.0)

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The 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 found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.