docs: Revise FAQ content for clarity and updates#22653
docs: Revise FAQ content for clarity and updates#22653sasakrsmanovic wants to merge 2 commits intomasterfrom
Conversation
Updated FAQ to clarify the differences between Uno Platform and .NET MAUI, as well as added information on AI integration and design tools.
There was a problem hiding this comment.
Pull request overview
This documentation PR updates the FAQ to clarify differences between Uno Platform and other frameworks (.NET MAUI and Blazor), highlighting new features like AI integration through MCPs and design tools. The changes also streamline the history description of Uno Platform and emphasize rendering flexibility.
Changes:
- Removed historical details about nventive's internal development period
- Added emphasis on rendering choice flexibility
- Reorganized and expanded differentiators from .NET MAUI, focusing on AI integration (MCPs), Hot Design Agent, and Figma integration
- Added similar AI and design tool information to the Blazor comparison section
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ### Who makes Uno Platform? | ||
|
|
||
| Uno Platform is an [open-source project](https://github.com/unoplatform/Uno) with many contributors. It was developed internally by [nventive](https://nventive.com) from 2013-2018, and has been open source since 2018. It's maintained by [Uno Platform](https://platform.uno). | ||
| Uno Platform is an [open-source project](https://github.com/unoplatform/Uno) with many contributors. Uno Platform has been open source since 2018. It's maintained by [Uno Platform](https://platform.uno). |
There was a problem hiding this comment.
The PR description contains "closes #" without an issue number. According to repository guidelines, every PR must reference a proper GitHub issue. Please provide the issue number and use the full format: "Closes https://github.com/unoplatform/uno/issues/#<ISSUE_NUMBER>"
There was a problem hiding this comment.
@copilot open a new pull request to apply changes based on this feedback
|
|
||
| Uno Platform and Blazor both make use of .NET's WebAssembly support to run natively in the browser. | ||
|
|
||
| In addition, Uno Platform provides two MCPs (Model Context Protocols) that enable AI agents to seamlessly access your live application's runtime state and visual tree. These MCPs work across any development environment – Visual Studio, VS Code, Claude Code, GitHub Copilot CLI, OpenAI Codex or Google Antigravity. |
There was a problem hiding this comment.
The reference to "Google Antigravity" appears to be incorrect. There is no known Google product by this name. This should likely be removed or replaced with an actual Google AI tool (such as "Google AI Studio" or "Gemini"). Please verify the intended reference.
doc/articles/faq.md
Outdated
| Third, Uno Platform provides two MCPs (Model Context Protocols) that enable AI agents to seamlessly access your live application's runtime state and visual tree. These MCPs work across any development environment – Visual Studio, VS Code, Claude Code, GitHub Copilot CLI, OpenAI Codex or Google Antigravity. | ||
|
|
||
| Fourth, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps. | ||
| Fourth, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps, as well as AI-powered Hot Design Agent to quickly scaffold yourd apps from prompts. | ||
|
|
||
| Fifth, Uno Platform provides an optional [Figma plugin](https://platform.uno/unofigma/) for pixel-perfect XAML export for Uno Platform apps. | ||
| Fifth, Uno Platform aligns with WinUI, which uses a flavor of XAML most Windows developers are familiar with. It also allows you to tap into WinUI's rich styling engine to create pixel-perfect applications. | ||
|
|
||
| Sixth, Uno Platform provides an excellent integration with Figma through either the [Figma plugin](https://platform.uno/unofigma/) for pixel-perfect XAML export for Uno Platform apps using a deterministic approach. Or you can use your Figma designs with Uno Platform MCPs to have those designs transformed into markup by prompting your favorite agent or CLI tool. |
There was a problem hiding this comment.
The ordering of the differentiators appears illogical. The third point discusses AI integration (MCPs), fourth discusses Hot Design, and fifth discusses WinUI alignment. It would be more logical to group related features together: keep WinUI/XAML alignment as a primary differentiator earlier in the list, and group AI-related features (MCPs, Hot Design Agent) together later.
| Third, Uno Platform provides two MCPs (Model Context Protocols) that enable AI agents to seamlessly access your live application's runtime state and visual tree. These MCPs work across any development environment – Visual Studio, VS Code, Claude Code, GitHub Copilot CLI, OpenAI Codex or Google Antigravity. | ||
|
|
||
| Fourth, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps. | ||
| Fourth, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps, as well as AI-powered Hot Design Agent to quickly scaffold yourd apps from prompts. |
There was a problem hiding this comment.
Spelling error: "yourd" should be "your"
|
|
||
| In addition, Uno Platform provides two MCPs (Model Context Protocols) that enable AI agents to seamlessly access your live application's runtime state and visual tree. These MCPs work across any development environment – Visual Studio, VS Code, Claude Code, GitHub Copilot CLI, OpenAI Codex or Google Antigravity. | ||
|
|
||
| Lastly, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps, as well as AI-powered Hot Design Agent to quickly scaffold yourd apps from prompts. |
There was a problem hiding this comment.
Spelling error: "yourd" should be "your"
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
|
@sasakrsmanovic I've opened a new pull request, #22654, to work on those changes. Once the pull request is ready, I'll request review from you. |
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| Third, Uno Platform provides two MCPs (Model Context Protocols) that enable AI agents to seamlessly access your live application's runtime state and visual tree. These MCPs work across any development environment – Visual Studio, VS Code, Claude Code, GitHub Copilot CLI, OpenAI Codex or Google Antigravity. | ||
|
|
||
| Fourth, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps. | ||
| Fourth, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps, as well as AI-powered Hot Design Agent to quickly scaffold yourd apps from prompts. |
There was a problem hiding this comment.
Trailing whitespace detected at the end of this line. Remove trailing whitespace to maintain consistent formatting.
| Fourth, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps, as well as AI-powered Hot Design Agent to quickly scaffold yourd apps from prompts. | |
| Fourth, Uno Platform provides [Hot Design](https://platform.uno/hot-design/) for visually designing your Uno Platform apps, as well as AI-powered Hot Design Agent to quickly scaffold yourd apps from prompts. |
| Second, Uno Platform can target additional platforms like Linux and the Web. | ||
|
|
||
| Third, Uno Platform aligns with WinUI, which uses a flavor of XAML most Windows developers are familiar with. It also allows you to tap into WinUI's rich styling engine to create pixel-perfect applications. | ||
| Third, Uno Platform provides two MCPs (Model Context Protocols) that enable AI agents to seamlessly access your live application's runtime state and visual tree. These MCPs work across any development environment – Visual Studio, VS Code, Claude Code, GitHub Copilot CLI, OpenAI Codex or Google Antigravity. |
There was a problem hiding this comment.
Inconsistent terminology: The documentation uses "Codex" or "Codex CLI" elsewhere (see doc/articles/get-started.md, doc/articles/get-started-ai-codex.md), but here it's referred to as "OpenAI Codex". For consistency with the rest of the documentation, consider using just "Codex" instead of "OpenAI Codex".
|
|
Updated FAQ to clarify the differences between Uno Platform and .NET MAUI, as well as added information on AI integration and design tools.
GitHub Issue: closes #
PR Type:
What is the current behavior? 🤔
What is the new behavior? 🚀
PR Checklist ✅
Please check if your PR fulfills the following requirements:
Screenshots Compare Test Runresults.Other information ℹ️