Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 6, 2026

PR Type:

📚 Documentation content changes

What is the current behavior? 🤔

Sample and tutorial documentation lacks structured information. Users must click through to determine if a sample matches their requirements (project structure, .NET version, target platforms, dependencies). No warnings exist for deprecated packages (IdentityServer4 EOL Dec 2022, IdentityModel.OidcClient) or outdated migration guides (Silverlight). External tutorials presented without currency indicators.

What is the new behavior? 🚀

New Samples Catalog Page (samples-catalog.md, 260 lines)

Structured metadata tables for each sample:

| Property | Value |
|----------|-------|
| **.NET Version** | .NET 9.0+ |
| **Project Structure** | Single Project / Multi-head |
| **Target Frameworks** | iOS, Android, WebAssembly, Windows, macOS, Linux |
| **Key UnoFeatures** | Extensions, MVUX, Navigation, Http |
| **Third-party Packages** | With versions & warnings |
| **Tutorial Available** | Yes - Maintained in Uno Docs |
| **Status** | ✅ Active / ⚠️ Deprecated |

Navigation aids:

  • Beginner starting points with recommended samples
  • Filtering guidance by UnoFeatures and platforms
  • Project structure explanations (Single Project vs Multi-head)

Safety warnings:

  • IdentityServer4: ⚠️ EOL December 2022, migrate to Duende IdentityServer
  • IdentityModel.OidcClient: ⚠️ Deprecated, use Uno.Extensions.Authentication.Oidc
  • Multi-head projects: flagged as older pattern

Enhanced Community Tutorials Page

Transformed from simple list to structured resource:

#### Tutorial Title

**Author:** Name (Credentials)
**Link:** [URL]
**Published:** Date
**Type:** Multi-part series
**Topics:** Feature coverage
**Status:** ⚠️ External - verify currency

Added guidance on assessing tutorial currency (publication date, .NET version, project structure).

Silverlight Migration Warning

Added prominent CAUTION notice highlighting outdated content (2021 patterns, deprecated packages, legacy project structures) with links to current resources.

Sample Documentation Template (.sample-template.md)

Reusable template ensuring consistent metadata documentation for future contributions.

PR Checklist ✅

  • 📝 Commits follow Conventional Commits
  • 🧪 Tests added (N/A - documentation only)
  • 📚 Docs updated per template
  • 🖼️ Screenshots validated (N/A - documentation only)
  • ❗ Contains NO breaking changes

Other information ℹ️

Files changed: 6 files (+599, -12 lines)

  • New: samples-catalog.md, .sample-template.md
  • Updated: community-tutorials.md, silverlight-migration-landing.md, samples-tutorials-overview.md, toc.yml

All xref links validated against existing UIDs. Markdown syntax and table formatting verified.

Original prompt

This section details on the original issue you should resolve

<issue_title>Improve sorting on samples, community tutorial and additional resources pages</issue_title>
<issue_description>### What could be improved? 🤔

The samples, tutorials and additional resources docs pages should contain a Table / information per Sample Entry, which will allow Consumers and especially Beginners, to see already before clicking on this Link, if those Specs are matching with the required or expected Information and are fluentless usable when starting from current Uno App templates.

Possibly bring the Issue Table from the Uno.Samples Repo to a Docs published Page or to their appropriate Entry in the Uno.Samples Sourced List of contained Samples:

Important Information to include:

  • Description of the sample (e.g. FoodDelivery has no Description

  • The used Uno.Sdk and .NET Version

  • Project Structure: Single Head (as provided by latest Uno Templates) or Multi Head

  • List of TargetFrameworks which are proven to work for this Sample

  • activly used and shown UnoFeatures in this sample

  • used/required third Party Packages with version number.

    The Version Number would be important to know for example when the Package used is possibly depreciated, so the Consumer of this Sample App or Tutorial would be faced with an eventual additional Updating requirement, if the new version is even any longer compartible to Uno!
    Examples:

    It is strongly advised to migrate to Duende IdentityServer.
    [...]

  • Includes Step By Step Guide-Tutorial? Difference between:

    • Maintained in Uno Docs?

      • Contained in regular CommunityTutorials/Uno own Tutorials (like Counter etc) -> expectable to be up to date
      • OR Contained in Migration Docs? For example: Migrating from Silverlight is horribly out of date, but misses even a Agent Suitable Alert box to make them not consider those Information to be usable in current apps!!!
    • External Resource/Blog post? -> Potentially not up to date!

      • the "To Do" App, IS NOT the same as the Uno.Samples/Reference/ToDo + External ToDo App is still Multi Head Project, while the Uno owned version still misses completely a Tutorial
      • same like Uno.Samples/Reference/Commerce, which is only shown for Figma Plugin, but misses completely a Guide for those Users which might prefer our great new Hot Desingn or regular Hot Reload Development!

Concern 📚

Getting started with Uno 🚀

Renderer 🎨

  • Skia
  • Native

Affected platforms 📱💻🖥️

All platforms 🌍

Any feedback? 💬

Would add brevity and simplify the getting started with those contents 🚀</issue_description>

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


💡 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.

Co-authored-by: Jen-Uno <214558326+Jen-Uno@users.noreply.github.com>
@CLAassistant
Copy link

CLAassistant commented Jan 6, 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.
1 out of 2 committers have signed the CLA.

✅ Jen-Uno
❌ 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 Jan 6, 2026
Co-authored-by: Jen-Uno <214558326+Jen-Uno@users.noreply.github.com>
Copilot AI changed the title [WIP] Improve sorting on samples, tutorials and resources pages docs: Add comprehensive samples catalog with structured metadata and deprecation warnings Jan 6, 2026
Copilot AI requested a review from Jen-Uno January 6, 2026 17:38
@unodevops
Copy link
Contributor

⚠️⚠️ The build 190102 has failed on Uno.UI - docs.

@Jen-Uno Jen-Uno marked this pull request as ready for review January 6, 2026 18:09
Copilot AI review requested due to automatic review settings January 6, 2026 18:09
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR addresses issue #20884 by creating a comprehensive samples catalog with structured metadata to help users quickly identify samples matching their requirements without needing to click through to each one. The documentation now includes detailed information about .NET versions, project structures, target frameworks, UnoFeatures, dependencies, and tutorial availability, along with prominent warnings for deprecated packages and outdated migration guides.

Key Changes:

  • New samples catalog page with detailed metadata tables for each sample (Featured Applications, Workshop Projects, Uno.Samples Repository entries, and Legacy/Migration Samples)
  • Enhanced community tutorials page with structured information including author credentials, publication dates, and currency assessment guidance
  • Added prominent deprecation warnings to the Silverlight migration landing page highlighting outdated content from 2021
  • New sample documentation template for future contributions
  • Updated navigation structure separating "Samples Catalog" from "Samples Repository"

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
doc/articles/toc.yml Added new "Samples Catalog" navigation entry separate from "Samples Repository" to distinguish between the informational catalog and the GitHub repository
doc/articles/samples-tutorials-overview.md Added prominent link to the new Samples Catalog page and clarified that Samples Repository refers to the GitHub repository containing the actual projects
doc/articles/samples-catalog.md New 260-line comprehensive catalog with structured metadata tables for all major samples, including .NET versions, project structures, UnoFeatures, deprecation warnings for IdentityServer4 and IdentityModel.OidcClient, and beginner guidance
doc/articles/guides/silverlight-migration/silverlight-migration-landing.md Added comprehensive CAUTION notice warning that the Silverlight migration documentation is outdated (2021), uses deprecated packages, and should not be used for current development
doc/articles/guides/community-tutorials.md Transformed from simple list to structured resource with detailed author information, publication dates, tutorial series breakdowns, and guidance on assessing tutorial currency and adapting older content
doc/.sample-template.md New reusable template for documenting samples with consistent metadata structure, ensuring future sample documentation follows the same comprehensive format established in the catalog

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@unodevops
Copy link
Contributor

⚠️⚠️ The build 190117 has failed on Uno.UI - docs.

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 kind/documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve sorting on samples, community tutorial and additional resources pages

4 participants