Skip to content

Commit 5604e22

Browse files
committed
Fix upgrade notes skill and add latest upgrade note to registry
CR: Lee
1 parent 576608a commit 5604e22

3 files changed

Lines changed: 25 additions & 13 deletions

File tree

.claude/skills/xh-upgrade-notes/SKILL.md

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -160,22 +160,20 @@ this is a new release — add it following the existing pattern.
160160

161161
### Update the MCP Doc Registry
162162

163-
Add a `RawEntry` to the `getRawEntries()` function in `mcp/data/doc-registry.ts` so the new
164-
upgrade notes are discoverable via `hoist-search-docs`. Place the entry after the existing upgrade
165-
note entries in the "Upgrade Notes" section, following this pattern:
163+
Add an entry to the `entries` array in `docs/doc-registry.json` so the new upgrade notes are
164+
discoverable via `hoist-search-docs`. Place the entry after the last existing upgrade-notes entry
165+
(at the end of the `entries` array), following this pattern:
166166

167-
```typescript
167+
```json
168168
{
169-
id: 'upgrade-v{NN}',
170-
title: 'v{NN} Upgrade Notes',
171-
file: 'docs/upgrade-notes/v{NN}-upgrade-notes.md',
172-
category: 'devops',
173-
description:
174-
'Upgrade guide from v{PRIOR}.x to v{VERSION}. {Difficulty} difficulty.',
175-
keywords: splitKeywords(
176-
'upgrade, migration, breaking changes, v{NN}, v{PRIOR}'
177-
)
169+
"id": "docs/upgrade-notes/v{NN}-upgrade-notes.md",
170+
"title": "v{NN} Upgrade Notes",
171+
"mcpCategory": "devops",
172+
"viewerCategory": "upgrade",
173+
"description": "Upgrade guide from v{PRIOR}.x to v{NN}.0.0. {Difficulty} difficulty.",
174+
"keywords": ["upgrade", "migration", "breaking changes", "v{NN}", "v{PRIOR}"]
178175
}
176+
```
179177

180178
## Phase 4: Dry-Run Validation
181179

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,12 @@
33
## 84.0.0-SNAPSHOT - unreleased
44

55

6+
## 83.0.1 - 2026-03-25
7+
8+
### ⚙️ Technical
9+
10+
* Update upgrade notes skill to properly register upgrade note
11+
612
## 83.0.0 - 2026-03-24
713

814
### 💥 Breaking Changes (upgrade difficulty: 🟢 LOW)

docs/doc-registry.json

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -442,6 +442,14 @@
442442
"viewerCategory": "upgrade",
443443
"description": "Upgrade guide from v81.x to v82.0.0. Low difficulty.",
444444
"keywords": ["upgrade", "migration", "breaking changes", "v82", "v81", "Picker", "DashCanvas", "MCP", "Filter"]
445+
},
446+
{
447+
"id": "docs/upgrade-notes/v83-upgrade-notes.md",
448+
"title": "v83 Upgrade Notes",
449+
"mcpCategory": "devops",
450+
"viewerCategory": "upgrade",
451+
"description": "Upgrade guide from v82.x to v83.0.0. Low difficulty.",
452+
"keywords": ["upgrade", "migration", "breaking changes", "v83", "v82", "TraceService", "tracing", "OTEL", "static defaults", "GridModel", "downloadBlob", "downloadViaUrl", "downloadjs", "SegmentedControl", "CheckboxButton"]
445453
}
446454
]
447455
}

0 commit comments

Comments
 (0)