Skip to content

Docs: Replace Complex (Nested) Bindings with BindingBase binding - #653

Merged
jfversluis merged 2 commits into
MicrosoftDocs:mainfrom
stephenquan:feature/bind-extensions
Jul 22, 2026
Merged

Docs: Replace Complex (Nested) Bindings with BindingBase binding#653
jfversluis merged 2 commits into
MicrosoftDocs:mainfrom
stephenquan:feature/bind-extensions

Conversation

@stephenquan

Copy link
Copy Markdown
Contributor

This PR replaces the Complex (Nested) Bindings and Complex (Nested) Bindings Example sections with a new BindingBase bindings section. The new guidance uses the BindingBase overload of .Bind(), which provides a single, consistent approach for one-way, two-way, and nested bindings while supporting compiled bindings and compile-time validation of binding expressions. By replacing the previous complex handler-based approach, the documentation becomes simpler and easier to follow while still supporting the same binding scenarios.

@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 de4feec:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/maui/markup/extensions/bindable-object-extensions.md ⚠️Warning View Details

docs/maui/markup/extensions/bindable-object-extensions.md

  • Line 45, Column 65: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/dotnet/api/microsoft.maui.controls.bindingbase.create' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 45, Column 65: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/dotnet/api/microsoft.maui.controls.bindingbase.create' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@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 f5087bf:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/markup/extensions/bindable-object-extensions.md ✅Succeeded View

For more details, please refer to the build report.

@TheCodeTraveler TheCodeTraveler 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.

Thanks Stephen!

@jfversluis
jfversluis merged commit 45517ad into MicrosoftDocs:main Jul 22, 2026
3 checks passed
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