Skip to content

.NET 11 RC 1: document platform and asset features - #3502

Open
davidortinau wants to merge 3 commits into
dotnet:mainfrom
davidortinau:davidortinau-rc1-platform-docs
Open

davidortinau wants to merge 3 commits into
dotnet:mainfrom
davidortinau:davidortinau-rc1-platform-docs

Conversation

@davidortinau

@davidortinau davidortinau commented Sep 2, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Add .NET 11 guidance for themed splash screens, including Android night resources and Apple platform version fallbacks.
  • Document ResizeQuality values, defaults, supported assets, and Resizetizer effects.
  • Document the opt-in Android system bar background synchronization property and its icon appearance boundary.

Source verification

All three MAUI merge commits are ancestors of the RC 1 source cut identified in dotnet/core#10552.

Validation

  • Targeted markdownlint: 0 errors
  • Moniker balance, article date, and whitespace checks passed
  • Independent factual review against PR bodies, diffs, merged source, and current net11.0 source passed
  • Local DocFX v3 validation was not available in this repository environment

Internal previews

File Preview link
docs/user-interface/controls/window.md Learn preview
docs/user-interface/images/images.md Learn preview
docs/user-interface/images/splashscreen.md Learn preview

Build report

Document themed splash screens, Resizetizer quality metadata, and opt-in Android system bar backgrounds.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings September 2, 2026 20:12
@davidortinau
davidortinau requested a review from a team as a code owner September 2, 2026 20:12
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

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.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit c6b77af:

✅ Validation status: passed

File Status Preview URL Details
docs/user-interface/controls/window.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/images/images.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/images/splashscreen.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

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.

Copilot review overview

🟡 Changes recommended

A couple of documentation clarity issues in the new splash screen section should be addressed to avoid reader confusion when following the examples.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review tier: Lite
Findings: 2 Low severity

New issues introduced by this change (2)
Severity Finding
Low severity docs/​user-interface/​images/​splashscreen.md — The dark-splash example switches from splashscreen.svg (used earlier on this page) to…
Low severity docs/​user-interface/​images/​splashscreen.md — drawable-night-* looks like a literal folder name, but Android uses qualifier combinations (for…
What changed in this PR

Adds .NET MAUI .NET 11 RC1 documentation updates for new asset/theming and Android platform behaviors, using monikered sections to keep earlier versions unaffected.

Changes:

  • Adds .NET 11 guidance for dark-themed splash screens, including Android night resources and Apple platform version fallback behavior.
  • Documents Resizetizer ResizeQuality options and how they affect asset generation.
  • Documents an opt-in Android system bar background synchronization MSBuild property.
File Description
docs/​user-interface/​images/​splashscreen.md Adds >=net-maui-11.0 section for dark theme splash screens and platform-specific generation details.
docs/​user-interface/​images/​images.md Adds >=net-maui-11.0 section documenting ResizeQuality and example usage.
docs/​user-interface/​controls/​window.md Adds >=net-maui-11.0 section documenting MauiAndroidSystemBarsUseMauiChrome behavior and its relationship to Window.StatusBarTheme.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@davidortinau davidortinau changed the title Document .NET 11 RC 1 platform and asset features .NET 11 RC 1: document platform and asset features Sep 2, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

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.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit c9e8a02:

✅ Validation status: passed

File Status Preview URL Details
docs/user-interface/controls/window.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/images/images.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/images/splashscreen.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@davidortinau
davidortinau enabled auto-merge (squash) September 9, 2026 14:04
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 140551e:

✅ Validation status: passed

File Status Preview URL Details
docs/user-interface/controls/window.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/images/images.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/images/splashscreen.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

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.

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.

3 participants