Skip to content

docs: add comprehensive Xamarin.Forms migration guides (backport #22526)#22557

Merged
agneszitte merged 25 commits intorelease/stable/6.5from
mergify/bp/release/stable/6.5/pr-22526
Feb 3, 2026
Merged

docs: add comprehensive Xamarin.Forms migration guides (backport #22526)#22557
agneszitte merged 25 commits intorelease/stable/6.5from
mergify/bp/release/stable/6.5/pr-22526

Conversation

@mergify
Copy link
Contributor

@mergify mergify bot commented Feb 3, 2026

  • Review existing Xamarin.Forms migration documentation structure
  • Create data-binding.md migration guide
  • Create effects.md migration guide
  • Create animations.md migration guide
  • Create custom-drawn-controls.md migration guide
  • Create custom-controls.md migration guide
  • Create control-mappings.md with comprehensive control reference
  • Create navigation.md based on blog post content
  • Create native-controls.md covering renderers and bindings
  • Update toc.yml to reference all new local pages
  • Update overview.md "What's covered" section to link to all pages
  • Verify all UIDs are consistent and cross-links work
  • Validate documentation structure
  • Check for conflicts with existing content
  • Review phrasing for XF migration context
  • Fix Microsoft Learn API links (Frame, NavigationView)
  • Complete comprehensive API review per Microsoft docs
Original prompt

Update Uno Platform documentation to add/refresh Xamarin.Forms migration content based on issue https://github.com/unoplatform/private/issues/342.

Repository: unoplatform/uno

Goals:

  1. Review existing Xamarin.Forms migration docs and ensure accuracy.

  2. Add new first-class documentation pages (in-repo markdown) derived from the following blog posts referenced by the issue:

  3. Update navigation so the docs point to these new pages instead of external blog links:

    • Update doc/articles/guides/xf-migration/toc.yml to reference the new pages using xref or local href.
    • Update doc/articles/guides/xf-migration/overview.md “What’s covered” section to link to the new pages.
  4. Ensure doc build metadata is correct:

    • Add proper front-matter uid: for new docs pages under the Uno.XamarinFormsMigration.* namespace.
    • Use consistent headings and cross-links between pages (Overview -> Intro -> topic pages).
  5. Follow repository conventions:

    • Prefer existing doc patterns and any repo docs guidelines.
    • Keep changes scoped to documentation.

PR description requirements:

Commit message must follow Conventional Commits, likely:

  • docs: add Xamarin.Forms migration guides

Acceptance criteria:

  • New markdown docs pages exist for Data Binding, Effects, Animations, Custom Controls, and Custom-Drawn Controls.
  • xf-migration TOC and overview no longer link out to the blog posts for those items.
  • Links build correctly (xref/uid works) and the docs are internally navigable.

This pull request was created from Copilot chat.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.


This is an automatic backport of pull request #22526 done by Mergify.

@mergify mergify bot added the conflicts label Feb 3, 2026
@mergify
Copy link
Contributor Author

mergify bot commented Feb 3, 2026

Cherry-pick of 22f6339 has failed:

On branch mergify/bp/release/stable/6.5/pr-22526
Your branch is ahead of 'origin/release/stable/6.5' by 19 commits.
  (use "git push" to publish your local commits)

You are currently cherry-picking commit 22f6339ee6.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   build/cSpell.json

no changes added to commit (use "git add" and/or "git commit -a")

Cherry-pick of 2c73337 has failed:

On branch mergify/bp/release/stable/6.5/pr-22526
Your branch is ahead of 'origin/release/stable/6.5' by 23 commits.
  (use "git push" to publish your local commits)

You are currently cherry-picking commit 2c73337eb4.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   build/cSpell.json

no changes added to commit (use "git add" and/or "git commit -a")

To fix up this pull request, you can check it out locally. See documentation: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally

@CLAassistant
Copy link

CLAassistant commented Feb 3, 2026

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
2 out of 3 committers have signed the CLA.

✅ Jen-Uno
✅ ajpinedam
❌ Copilot
You have signed the CLA already but the status is still pending? Let us recheck it.

@github-actions github-actions bot added area/build Categorizes an issue or PR as relevant to build infrastructure kind/documentation labels Feb 3, 2026
Copilot AI and others added 23 commits February 3, 2026 16:50
Co-authored-by: Jen-Uno <214558326+Jen-Uno@users.noreply.github.com>
Co-authored-by: Jen-Uno <214558326+Jen-Uno@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Jen-Uno <214558326+Jen-Uno@users.noreply.github.com>
Clarify the usage of control templates and conditional compilation in the context of native control features.
Corrected formatting and added missing bullet points in the custom controls documentation.
Clarified the recommendation for using SKCanvasElement over SKXamlCanvas in migration documentation.
Updated the data-binding guide to clarify converter usage when migrating from Xamarin.Forms to Uno Platform.
Added 'Swipeable' and 'backgrounded' to the cSpell dictionary.
Removed extra line breaks in the custom controls guide.
@agneszitte agneszitte force-pushed the mergify/bp/release/stable/6.5/pr-22526 branch from 26d8660 to cd6b328 Compare February 3, 2026 21:51
@agneszitte agneszitte merged commit 3ee1fd1 into release/stable/6.5 Feb 3, 2026
10 of 12 checks passed
@agneszitte agneszitte deleted the mergify/bp/release/stable/6.5/pr-22526 branch February 3, 2026 22:00
@unodevops
Copy link
Contributor

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22557/docs/index.html

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/build Categorizes an issue or PR as relevant to build infrastructure conflicts kind/documentation

6 participants