Skip to content

.NET 11: document Preview 7 XAML tooling - #3454

Merged
jfversluis merged 5 commits into
dotnet:mainfrom
davidortinau:davidortinau-preview-7-xaml-docs
Aug 11, 2026
Merged

.NET 11: document Preview 7 XAML tooling#3454
jfversluis merged 5 commits into
dotnet:mainfrom
davidortinau:davidortinau-preview-7-xaml-docs

Conversation

@davidortinau

@davidortinau davidortinau commented Aug 6, 2026 •
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Contributor

Summary

  • document XAML Incremental Hot Reload as enabled by default for Debug builds in .NET 11 Preview 7, with Release/publish defaults and the legacy opt-out path
  • document XAML updates with dotnet watch
  • document trim-safe SourceGen compilation for RelativeSource AncestorType bindings and exact runtime fallback and diagnostic behavior

Source verification

Validation

  • markdownlint: 0 issues
  • targeted link checks: passed
  • metadata and moniker checks: passed
  • factual pre-push review against shipped Preview 7 source: clean
  • diff check: clean

Internal previews

File Preview link
docs/fundamentals/data-binding/compiled-bindings.md docs/fundamentals/data-binding/compiled-bindings
docs/xaml/hot-reload.md docs/xaml/hot-reload

Copilot AI review requested due to automatic review settings August 6, 2026 12:33
@davidortinau
davidortinau requested a review from a team as a code owner August 6, 2026 12:33
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 6, 2026

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

learn-build-service-prod Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 32f0a1d:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/data-binding/compiled-bindings.md ✅Succeeded View (>=net-maui-8.0)
docs/xaml/hot-reload.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

Copilot AI reviewed Aug 6, 2026
View reviewed changes

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

Updates .NET MAUI documentation for .NET 11 Preview 7 by adding version-gated guidance on the new opt-in XAML Incremental Hot Reload engine and on trim-safe compiled RelativeSource ancestor bindings (with runtime fallback behavior).

Changes:

  • Added a >=net-maui-11.0 section to document enabling XAML Incremental Hot Reload via EnableMauiIncrementalHotReload.
  • Added a >=net-maui-11.0 section describing compilation of RelativeSource AncestorType bindings into trim-safe compiled bindings, with fallback cases.
  • Refreshed ms.date metadata on touched pages.
Show a summary per file
File Description
docs/xaml/hot-reload.md Adds .NET 11+ documentation for enabling and understanding the new incremental hot reload engine.
docs/fundamentals/data-binding/compiled-bindings.md Adds .NET 11+ documentation for trim-safe compilation of RelativeSource ancestor bindings and fallback behavior.

Copilot's findings

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

Comment thread docs/fundamentals/data-binding/compiled-bindings.md
@davidortinau davidortinau mentioned this pull request Aug 6, 2026
Merged
This was referenced Aug 7, 2026
Closed
Closed
Closed
davidortinau and others added 3 commits August 11, 2026 08:20
@davidortinau
XAML (.NET 11): document Preview 7 tooling
4a1d043 
Document opt-in incremental XAML Hot Reload and trim-safe RelativeSource ancestor binding compilation.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@davidortinau
XAML (.NET 11): correct binding fallback guidance
d3864d8 
Remove unresolved AncestorType from runtime fallback examples because type resolution failures stop XAML compilation.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@davidortinau
XAML (.NET 11): align Preview 7 release guidance
1669fa6 
Document Debug-default incremental hot reload and exact SourceGen binding fallback behavior.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: b999d371-fbce-41a9-81f6-8167d7dc9cdf
@davidortinau
davidortinau force-pushed the davidortinau-preview-7-xaml-docs branch from 32f0a1d to 1669fa6 Compare August 11, 2026 13:28
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 11, 2026

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

learn-build-service-prod Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 1669fa6:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/data-binding/compiled-bindings.md ✅Succeeded View (>=net-maui-8.0)
docs/xaml/hot-reload.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@davidortinau
XAML (.NET 11): clarify unresolved ancestor behavior
a71ee1b 
State that unresolved AncestorType values fail XAML compilation without assigning one diagnostic code to every syntax.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: b999d371-fbce-41a9-81f6-8167d7dc9cdf
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit a71ee1b:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/data-binding/compiled-bindings.md ✅Succeeded View (>=net-maui-8.0)
docs/xaml/hot-reload.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@learn-build-service-prod

learn-build-service-prod Bot commented Aug 11, 2026

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.

@davidortinau
XAML (.NET 11): remove legacy Source flag condition
494867e 
Clarify that SourceGen compiles resolvable RelativeSource AncestorType bindings independently of the legacy XamlC Source compilation flag.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: b999d371-fbce-41a9-81f6-8167d7dc9cdf
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 11, 2026

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

learn-build-service-prod Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 494867e:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/data-binding/compiled-bindings.md ✅Succeeded View (>=net-maui-8.0)
docs/xaml/hot-reload.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@davidortinau

davidortinau commented Aug 11, 2026

Copy link
Copy Markdown
Contributor Author

@jfversluis Release-day review requested. Final Preview 7 source verification is complete for Debug-default XAML Incremental Hot Reload and exact SourceGen RelativeSource/x:Reference behavior. CI is fully green; human approval is the only blocker.

@jfversluis
jfversluis merged commit aa5e65f into dotnet:main Aug 11, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
@jfversluis jfversluis jfversluis approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@davidortinau @jfversluis