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:

• Date heading (e.g., ### January 19, 2026 )

• Link to full notes

• 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

Parameter Required Default

dotnetVersions no Two most recent stable versions

includePrerelease no false

Output

Versions changed:

• New release-notes/maui-release-notes-{YYYYMMDD}.md

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