docs: Fix misleading Web Authentication documentation suggesting WebView usage

[Copilot]

GitHub Issue (If applicable): closes #

PR Type

• Documentation content changes

What is the current behavior?

Documentation incorrectly states that WebAuthenticationProvider uses a "web view" control, implying an embedded WebView component. The actual implementation uses WebAuthenticationBroker API (system authentication window on most platforms) and WinUIEx.WebAuthenticator on Windows.

This creates confusion as evidenced by:

• Page title: "Authenticate Users with a Web View"
• Navigation breadcrumb showing "Web View"
• Multiple references to "web view" throughout documentation
• No mention of actual WebAuthenticationBroker API being used

What is the new behavior?

Documentation accurately describes the authentication mechanism:

Files updated:

• doc/Learn/Walkthrough/Authentication.Web.howto.md

  • Title: "Authenticate Users with Web Authentication"
  • Heading: "Let users sign in with web authentication"
  • Replaced "web view" references with accurate terminology: "system authentication window (which may use a system browser)"
  • Clarified that WebAuthenticationBroker API displays an authentication window

• doc/Learn/Authentication/HowTo-WebAuthentication.md

  • Updated provider description to specify WebAuthenticationBroker API usage
  • Clarified LoginStartUri opens via WebAuthenticationBroker, not embedded WebView

• doc/Learn/Authentication/AuthenticationOverview.md

  • Updated Web provider description to match actual implementation

Terminology improvements:

• Changed "system browser or authentication window" to "system authentication window (which may use a system browser)" for clarity
• Consistently uses "authentication window" to better reflect that WebAuthenticationBroker displays a dedicated authentication window rather than opening the user's default browser

Technical accuracy verified against source:

// src/Uno.Extensions.Authentication.UI/Web/WebAuthenticationProvider.cs
#if WINDOWS
    var userResult = await WinUIEx.WebAuthenticator.AuthenticateAsync(...);
#else
    var userResult = await WebAuthenticationBroker.AuthenticateAsync(...);
#endif

PR Checklist

• Tested code with current supported SDKs
• Docs have been added/updated which fit documentation template. (for bug fixes / features)
• Unit Tests and/or UI Tests for the changes have been added (for bug fixes / features) (if applicable)
• Wasm UI Tests are not showing unexpected any differences. Validate PR Screenshots Compare Test Run results.
• Contains NO breaking changes
• Updated the Release Notes
• Associated with an issue (GitHub or internal)

Other information

No WebView UnoFeature is required (correctly documented). Only Authentication feature needed.

Internal Issue (If applicable):

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[WebView] [Auth] Wrong Docs title suggesting to be able to use Web Auth provider with WebView</issue_title>
<issue_description>

On which page?

https://github.com/unoplatform/uno.extensions/blob/3faa9bc30d6bd0e3cdacf497f8da71a777b0e53f/doc/Learn/Walkthrough/Authentication.Web.howto.md

What's wrong?

The Docs page TOC Entry and Caption is clearly stating that we would be able to use WebView (2?) alongside with Web Authantication Provider, which is at this time at least just wrong!
It would be nice if we could! but not this time.

Also as marked in the secrond screenshot, there would eventually miss the WebView UnoFeature entry also.

Any feedback?

@Kunal22shah you seem to touched this doc the last time, may you can correct this information please?

And just if somone of the Team is interesten in an eventually way to do this with WebView2 as we are now WinUI3 based not UWP itself, maybe you want to check out this msal source code 🚀

• https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/964a07449f9d5183828fbd0e1e9d4d3e9b6d80c7/src/client/Microsoft.Identity.Client.Desktop/WebView2WebUi/WebView2WebUi.cs
• https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/964a07449f9d5183828fbd0e1e9d4d3e9b6d80c7/src/client/Microsoft.Identity.Client.Desktop.WinUI3/WebView2WebUi/WinUI3WindowWithWebView2.cs
• https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/964a07449f9d5183828fbd0e1e9d4d3e9b6d80c7/src/client/Microsoft.Identity.Client.Broker/RuntimeBroker.cs
• https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/src/client/Microsoft.Identity.Client/OAuth2/OAuth2Client.cs
• https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/src/client/Microsoft.Identity.Client/Platforms/netdesktop/NetDesktopPlatformProxy.cs
• https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/src/client/Microsoft.Identity.Client/Platforms/Features/DesktopOS/WindowsNativeMethods.cs

just maybe you could even implement this for Uno WebAuthenticationBrokerProvider on Desktop? That would be awesome!
@kazo0 FYI </issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [WebView] [Auth] Wrong Docs title suggesting to be able to use Web Auth provider with WebView #2972

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[github-actions]

Azure Static Web Apps: Your stage site is ready! Visit it here: https://delightful-moss-0c5b8040f-3012.eastus2.azurestaticapps.net

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[Copilot]

Pull request overview

This PR corrects misleading documentation that incorrectly described WebAuthenticationProvider as using an embedded "web view" control. The documentation is updated to accurately reflect that the implementation uses the system's WebAuthenticationBroker API (or WinUIEx.WebAuthenticator on Windows), which displays a system browser or authentication window rather than an embedded WebView component.

Changes:

• Updated page title from "Authenticate Users with a Web View" to "Authenticate Users with Web Authentication"
• Replaced all "web view" references with "WebAuthenticationBroker API" or "system browser/authentication window"
• Clarified authentication flow descriptions to match actual implementation

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
doc/Learn/Walkthrough/Authentication.Web.howto.md	Updated title, heading, and multiple references throughout to replace "web view" with accurate WebAuthenticationBroker terminology
doc/Learn/Authentication/HowTo-WebAuthentication.md	Updated provider description and LoginStartUri documentation to specify WebAuthenticationBroker API usage
doc/Learn/Authentication/AuthenticationOverview.md	Updated Web provider description to match actual implementation

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

Azure Static Web Apps: Your stage site is ready! Visit it here: https://delightful-moss-0c5b8040f-3012.eastus2.azurestaticapps.net

[github-actions]

Azure Static Web Apps: Your stage site is ready! Visit it here: https://delightful-moss-0c5b8040f-3012.eastus2.azurestaticapps.net

[Jen-Uno]

@copilot apply changes based on the comments in this thread

[github-actions]

Azure Static Web Apps: Your stage site is ready! Visit it here: https://delightful-moss-0c5b8040f-3012.eastus2.azurestaticapps.net

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.