.NET Release Notes

Generate and maintain release notes for .NET preview, RC, and GA releases.

This skill is the editorial writing stage of the pipeline. It turns a scored features.json file into the markdown that ships in this repository.

How it works

1. generate-changes diffs source-manifest.json between VMR refs to produce changes.json
2. generate-features reads changes.json, resolves revert/backout relationships, and emits features.json with optional scores using the shared editorial-scoring rubric
3. update-existing-branch handles incremental reruns when a milestone branch already exists, merging deltas instead of restarting from scratch
4. api-diff / dotnet-inspect verifies public APIs and confirms suspect features still exist in the shipped build
5. release-notes writes curated markdown using the higher-value entries from features.json
6. review-release-notes runs a final multi-model editorial QA pass against the scoring rubric and examples
7. Output is one PR per release milestone in dotnet/core, maintained incrementally

Existing-branch reruns

When the milestone branch already exists and contains drafted markdown, invoke update-existing-branch. That shared skill is the canonical playbook for refreshing changes.json, merging the delta into features.json, integrating new material into existing sections, and handling review comments without clobbering human edits.

Reference documents

• quality-bar.md — what good release notes look like
• vmr-structure.md — VMR branches, tags, source-manifest.json
• ../update-existing-branch/SKILL.md — how to refresh a populated milestone branch incrementally
• changes-schema.md — the shared changes.json / features.json schema
• ../editorial-scoring/SKILL.md — the reusable scoring rubric and cut guidance
• feature-scoring.md — how to score and cut features
• component-mapping.md — components, product slugs, output files
• format-template.md — markdown document structure
• editorial-rules.md — tone, attribution, naming
• api-verification.md — using dotnet-inspect to verify APIs
• examples/ — curated examples from previous releases, organized by component. Read the examples for your component before writing. The examples/README.md lists 12 editorial principles derived from what works and what doesn't in past release notes.