Apply suggestions from code review

Co-authored-by: Maximilian Franzke <[email protected]>

Author: michaelmkraus

.changeset/README.md

@@ -67,6 +67,7 @@ After the Release PR is merged into `main` branch:
 - Run the publish script (`scripts/github/publish-npm.js`)
 - Publish new versions to npm with the tag `latest` (or `next` for pre-releases)
 - Push git tags
+- Create a [GitHub Release](https://github.com/db-ux-design-system/core-web/releases)
 
 You don’t have to run anything manually, it’s handled by CI.
 
@@ -96,11 +97,11 @@ You don’t have to run anything manually, it’s handled by CI.
 - **Baseline snapshots**
 
     ARIA snapshots by Playwright help detect markup changes. If they change, prefer minor instead of patch.
-    And please mention those HTML changes within the `CHANGELOG`.
+    And please mention those HTML changes within the `CHANGELOG` or of necessary (like bigger changes) in a [migration guide](https://github.com/db-ux-design-system/core-web/tree/main/docs/migration).
 
 - **Avoid manual version bumps**
 
-    Never edit package.json `version` field by hand. Changesets handles this automatically.
+    Never edit `package.json` `version` field by hand. Changesets handles this automatically.
 
 ---
 
@@ -159,7 +160,7 @@ npx changeset
 npx changeset status --verbose
 
 # Apply version bumps and changelogs
-npm run release:version
+npx changeset version
 
 # Publish (if you want to do it locally, not in CI)
 npm run release:publish

.github/workflows/changesets-release-pr.yml

@@ -14,7 +14,16 @@ on:
     types: [opened, synchronize, reopened, ready_for_review]
   push:
     branches: ["main"]
-  workflow_dispatch: {}
+  workflow_dispatch:
+    inputs:
+      action:
+        description: "Choose an action"
+        required: true
+        default: "version"
+        type: choice
+        options:
+          - version
+          - release
 
 permissions:
   # Needed to push version commit + create releases
@@ -32,7 +41,7 @@ jobs:
   preview:
     if: github.event_name == 'pull_request'
     name: 🔎 Changesets Preview (PR)
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       # Check out the PR HEAD commit (not the merge ref) to report the correct plan
       - name: ⏬ Checkout PR head (not merge ref)
@@ -99,7 +108,7 @@ jobs:
     # Only run on main pushes (merge to main done) to drive versioning + tags
     if: github.event_name == 'push' && startsWith(github.ref, 'refs/heads/main')
     name: 🧩 Create/Update Release PR (and cut tags/releases)
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
 
     steps:
       # Work on the main branch that was just pushed

.github/workflows/pull-request-snapshot-diff.yml

@@ -25,7 +25,7 @@ concurrency:
 jobs:
   snapshot-diff:
     name: 🔎 Snapshot changes (png/yml) & bump guard
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
 
     steps:
       -  # Check out the PR *head* commit (not the merge ref), with full history.
@@ -121,7 +121,7 @@ jobs:
           SNAP_SUMMARY_MD_PATH: ${{ env.SNAP_SUMMARY_MD_PATH }}
         with:
           script: |
-            const fs = require('fs');
+            const fs = require('node:fs');
             const { owner, repo, number } = context.issue;
             const marker = '<!-- snapshot-summary-marker -->';
             let body = '_No snapshot info._';

package.json

@@ -63,8 +63,6 @@
     "regenerate:screenshots": "npm run build && npm run build --workspace=react-showcase && docker-compose --file ./e2e/docker-compose.regenerate.yml up",
     "regenerate:screenshots:rebuild": "npm run rm:builds && node scripts/rebuild-e2e.js",
     "release:publish": "node scripts/github/publish-npm.js",
-    "release:status": "changeset status --verbose",
-    "release:version": "changeset version",
     "rm:builds": "npm run rm:builds --workspace=scripts",
     "start": "npm run start --workspace=patternhub",
     "test": "npm run test --workspace=scripts",