MAUI Release Notes Generator

Generate formatted markdown for .NET MAUI workload releases using live NuGet data from the dotnet-workload-info skill.

File Structure

release-notes/
├── maui-release-notes.md              # Index page with all releases
└── maui-release-notes-YYYYMMDD.md     # Dated release notes (one per update)

Workflow

Step 1: Gather workload data

Use dotnet-workload-info skill to fetch live data for the two most recent .NET versions (e.g., .NET 10 and .NET 9):

• •Workload set versions (NuGet + CLI format)
• •Individual workload versions (MAUI, iOS, Mac Catalyst, Android, tvOS, macOS)
• •MAUI NuGet package versions (implicit from workload vs latest on NuGet)
• •Apple dependencies (Xcode version, SDK)
• •Android dependencies (JDK, SDK packages)

Step 2: Check for version changes

Compare fetched data against most recent maui-release-notes-YYYYMMDD.md:

ls -1 release-notes/maui-release-notes-*.md | sort -r | head -1

Key versions to compare per .NET version:

• •Workload set version
• •MAUI version
• •iOS version
• •Android version

If any changed → proceed. If unchanged → report "versions are up to date".

Step 3: Generate dated release notes

Create release-notes/maui-release-notes-{YYYYMMDD}.md using templates from references/templates.md.

For link construction (NuGet URLs, GitHub release tags), see references/links.md.

Step 4: Update index page

Add new entry at top of release-notes/maui-release-notes.md:

• •Only include .NET version sections that had actual changes
• •Update "Last Updated" date

Index Entry Format

Each release entry includes:

1. •Date heading (e.g., ### January 19, 2026)
2. •Link to full notes
3. •Per-.NET version summary (only for versions with changes):
   • •Workload set version
   • •Workload versions table with Requirements column
   • •MAUI NuGet packages (implicit vs latest)

Requirements column:

• •Apple platforms: Xcode ≥ {version}
• •Android: API {level}, JDK {version}
• •MAUI: (empty)

Detailed Templates

See references/templates.md for:

• •Complete index page template
• •Full dated release notes template with all sections

Link Construction

See references/links.md for:

• •NuGet package URL patterns
• •GitHub release tag formats (including Apple platform tag algorithm)
• •Formatting conventions

Inputs

Output

Versions changed:

1. •New release-notes/maui-release-notes-{YYYYMMDD}.md
2. •Updated release-notes/maui-release-notes.md with new entry at top

Versions current: Informational message only

Dependencies

Requires dotnet-workload-info skill for live NuGet data. Never use cached/hardcoded versions.