.agents/skills/release-publish/references/release-notes.md
Annotate GitHub release notes with platform and community emojis.
| Section | When to Include |
|---|---|
| Breaking Changes | Only if there are breaking changes |
| New Features | Only if there are new features |
| What's Changed | Always (full list with all PRs) |
| Emoji | Meaning |
|---|---|
| ๐ | Apple (iOS/macOS/tvOS/Mac Catalyst) |
| ๐ช | Windows |
| ๐ง | Linux |
| ๐ค | Android |
| ๐ | WebAssembly/Blazor |
| ๐จ | Core API |
| ๐๏ธ | Build system/CI |
| ๐ฆ | General (fallback - always use something!) |
| Emoji | Meaning |
|---|---|
| โค๏ธ | Community contribution (not @mattleibow) |
| Label Pattern | Platform Emoji |
|---|---|
os/Windows* | ๐ช |
os/macOS, os/iOS, os/tvOS | ๐ |
os/Linux | ๐ง |
os/Android | ๐ค |
backend/SkiaSharp | ๐จ |
area/Build | ๐๏ธ |
| (no platform label) | ๐ฆ |
| Title Contains | Platform Emoji |
|---|---|
iOS, macOS, tvOS, Apple, Metal, Catalyst | ๐ |
Windows, Win, UWP, WinUI, Direct3D, D3D | ๐ช |
Linux, Alpine, riscv, LoongArch | ๐ง |
Android, NDK | ๐ค |
WebAssembly, Wasm, Blazor | ๐ |
SK* (API classes) | ๐จ |
Build, CI, Pipeline | ๐๏ธ |
| (no platform keywords) | ๐ฆ |
gh release view {tag} --json body -q '.body' > /tmp/skiasharp/release/release-body.md
For each PR line (format: * Description by @author in URL):
# Extract PR number from URL and fetch details
gh pr view {number} --json labels,author,title,body
Determine:
mattleibowBREAKING, removes APIAdd, Support, Enable, Implement, or bumps Skia/HarfBuzz[release/{version}] prefix (see below)Backport PRs have titles prefixed with [release/{version}] and are created by @github-actions. These should be traced back to the original PR for proper attribution.
Identifying backports:
[release/...]github-actions[bot]backport labelTracing to original:
# Get backport PR body - contains reference to original
gh pr view {backport-number} --json body -q '.body'
# Output: "Backport of {commit} from #{original-pr-number}."
# Get original PR details
gh pr view {original-pr-number} --json author,title,labels
Annotation format for backports:
* {emoji}{โค๏ธ} {clean title} (originally by @{original-author} in #{original-pr}) by @github-actions in {backport-url}
[release/{version}] prefix from the title(originally by @{author} in #{number}) before by @github-actionsFormat all items: * {platform}{โค๏ธ} Description...
gh release edit {tag} --notes-file /tmp/skiasharp/release/release-body.md
## Breaking Changes
* ๐จ Remove deprecated SKFoo API... by @mattleibow
## New Features
* ๐โค๏ธ Support SKMetalView on tvOS... by @MartinZikmund
* ๐งโค๏ธ Add riscv64 build support... by @kasperk81
## What's Changed
* ๐จ Remove deprecated SKFoo API... by @mattleibow
* ๐โค๏ธ Support SKMetalView on tvOS... by @MartinZikmund
* ๐ชโค๏ธ Enable Control Flow Guard... by @Aguilex
* ๐ฆ Adding the initial set of AI docs... by @mattleibow
* ๐๏ธ Bump to the next version... by @mattleibow
## New Contributors
(Auto-generated)
**Full Changelog**: (Auto-generated)
Original (auto-generated):
* Support SKMetalView on tvOS by @MartinZikmund in https://github.com/mono/SkiaSharp/pull/3114
* Fix the incorrect call in SafeRef by @kkwpsv in https://github.com/mono/SkiaSharp/pull/3143
* Adding the initial set of AI docs by @mattleibow in https://github.com/mono/SkiaSharp/pull/3406
After annotation:
* ๐โค๏ธ Support SKMetalView on tvOS by @MartinZikmund in https://github.com/mono/SkiaSharp/pull/3114
* ๐จโค๏ธ Fix the incorrect call in SafeRef by @kkwpsv in https://github.com/mono/SkiaSharp/pull/3143
* ๐ฆ Adding the initial set of AI docs by @mattleibow in https://github.com/mono/SkiaSharp/pull/3406
Original (auto-generated backport):
* [release/3.119.2-preview.2] Add Spectre mitigation flag for libSkiaSharp.dll. by @github-actions in https://github.com/mono/SkiaSharp/pull/3497
After tracing and annotation:
* ๐ชโค๏ธ Add Spectre mitigation flag for libSkiaSharp.dll. (originally by @sshumakov in #3496) by @github-actions in https://github.com/mono/SkiaSharp/pull/3497
Key changes:
[release/3.119.2-preview.2] prefix(originally by @sshumakov in #3496) attribution