Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 10, 2025

Updated XAML source generation documentation based on review feedback to correct terminology and improve content organization.

Changes

  • Terminology: Changed "preview" to "opt-in" in IMPORTANT admonitions—XAML source generation is released but requires explicit enablement
  • Content reordering: Promoted global project setting (MauiXamlInflator) as primary approach, repositioned per-file configuration as secondary option for fine-grained control
  • Markdown fixes: Corrected blockquote formatting in runtime-load.md

Recommended approach now reads:

<!-- Enable for entire project (recommended) -->
<PropertyGroup>
   <MauiXamlInflator>SourceGen</MauiXamlInflator>
</PropertyGroup>

<!-- Or for fine-grained control -->
<ItemGroup>
    <MauiXaml Update="**/*.xaml" Inflator="SourceGen" />
</ItemGroup>

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.


Internal previews

📄 File 🔗 Preview link
docs/xaml/fundamentals/get-started.md docs/xaml/fundamentals/get-started
docs/xaml/runtime-load.md docs/xaml/runtime-load

@learn-build-service-prod
Copy link

Learn Build status updates of commit a171d51:

✅ Validation status: passed

For more details, please refer to the build report.

- Changed "preview" to "opt-in" in IMPORTANT notes
- Reordered content to promote global setting first
- Added fine-grained control section with clear context
- Fixed markdown formatting (missing > characters in runtime-load.md)

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
@learn-build-service-prod
Copy link

Learn Build status updates of commit 948a1bf:

✅ Validation status: passed

File Status Preview URL Details
docs/xaml/fundamentals/get-started.md ✅Succeeded View (>=net-maui-8.0)
docs/xaml/runtime-load.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

Learn Build status updates of commit 948a1bf:

✅ Validation status: passed

File Status Preview URL Details
docs/xaml/fundamentals/get-started.md ✅Succeeded View (>=net-maui-8.0)
docs/xaml/runtime-load.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

Copilot AI changed the title [WIP] Add notes for XAML preview features Address PR feedback: refine XAML source generation documentation Nov 10, 2025
Copilot AI requested a review from jfversluis November 10, 2025 22:10
Copilot finished work on behalf of jfversluis November 10, 2025 22:10
@learn-build-service-prod
Copy link

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.

@jfversluis jfversluis marked this pull request as ready for review November 10, 2025 22:16
@jfversluis jfversluis requested a review from a team as a code owner November 10, 2025 22:16
@jfversluis jfversluis merged commit 8dfa4e2 into pr14-xaml-sourcegen-global-xmlns-net10-from-main Nov 10, 2025
9 checks passed
@jfversluis jfversluis deleted the copilot/sub-pr-2997 branch November 10, 2025 22:16
jfversluis added a commit that referenced this pull request Nov 11, 2025
* docs(.NET10): XAML preview features — source generator and global xmlns; add admonitions and examples; update ms.date

* revised source gen bits

* Update get-started.md

* Update get-started.md with XAML source generation info

Added instructions for enabling XAML source generation and improved namespace usage in .NET MAUI.

* Revise XAML source generation instructions for .NET MAUI

Updated instructions for enabling XAML source generation in .NET MAUI for .NET 10, including new examples and clarifications.

* Address PR feedback: refine XAML source generation documentation (#3079)

* Initial plan

* Address PR feedback: update XAML source generation docs

- Changed "preview" to "opt-in" in IMPORTANT notes
- Reordered content to promote global setting first
- Added fine-grained control section with clear context
- Fixed markdown formatting (missing > characters in runtime-load.md)

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

* Update docs/xaml/runtime-load.md

* Update docs/xaml/fundamentals/get-started.md

Co-authored-by: Stephane Delcroix <stephane@delcroix.org>

* Apply suggestions from code review

---------

Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Stephane Delcroix <stephane@delcroix.org>
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.

2 participants