docs(site): backfill and prose-ify beta changelogs#1794
Merged
Conversation
Parse CHANGELOG.md and generate raw changelog files for the 9 beta releases missing from site/src/content/changelog/ (beta.1-6, beta.13, beta.20, beta.21), using the same extraction logic and frontmatter schema as the release-pr workflow. Closes #1030 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01G9r6aQkL82k4o3JqcfjkD3
Encode lessons from the beta backfill pass: scale prose length to release size instead of a hard 100-300 words, describe internal-only releases honestly instead of skipping them into an empty body, paragraphs only, drop per-change author credits in favor of PR links, weave New Contributors into a closing thanks, and tighten the description field spec. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01G9r6aQkL82k4o3JqcfjkD3
Rewrite all 24 beta changelog entries from raw git-cliff bullets into narrative prose, following the changelog-prose workflow rules: lead with the most impactful changes, group related PRs into stories, call out breaking changes with migration guidance, and fill in the description frontmatter. PR context was pulled from the linked PRs; prose length scales with release size. Also fixes beta.19, whose pipeline-generated file had duplicated beta.20's content (#1338) and a self-referencing compareUrl; it now documents its actual change (#1337) and compares beta.18...beta.19. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01G9r6aQkL82k4o3JqcfjkD3
commitlint's scope-enum has no changelog scope, so PRs opened by the prose workflow would fail the commit check. Use docs(site) instead. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01G9r6aQkL82k4o3JqcfjkD3
✅ Deploy Preview for vjs10-site ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
📦 Bundle Size Report🎨 @videojs/html — no changesPresets (7)
Media (10)
Players (5)
Skins (30)
UI Components (39)
Sizes are marginal over the root entry point. ⚛️ @videojs/react — no changesPresets (7)
Media (9)
Skins (27)
UI Components (33)
Sizes are marginal over the root entry point. 🧩 @videojs/core — no changesEntries (14)
🏷️ @videojs/element — no changesEntries (2)
📦 @videojs/store — no changesEntries (3)
🔧 @videojs/utils — no changesEntries (10)
📦 @videojs/spf — no changesEntries (4)
ℹ️ How to interpretJS sizes are initial static graph totals (minified + brotli). Lazy dynamic chunks are shown separately when present.
Run |
mihar-22
approved these changes
Jul 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #1030
Backfills the missing beta changelog entries and translates all 24 of them into narrative prose, applying the rules from the
changelog-proseworkflow by hand since those releases predate the (now fixed, #1792) pipeline.What's here
1. Raw backfill (#1030 as written) —
docs(site): backfill raw changelogs for past betasGenerates the 9 missing files (beta.1–6, beta.13, beta.20, beta.21) from root
CHANGELOG.md, using the same extraction logic and frontmatter schema as therelease-pr.ymlsite-extract step. Kept as its own commit so the raw → prose transformation is reviewable per file.2. Prose for all 24 betas —
docs(site): add changelog prose for all beta releasesEach entry follows the
changelog-prose.ymlprompt rules andwriting-style.md: lead with the most impactful changes, group related PRs into stories (with PR context pulled from the linked PRs), explicit migration guidance for the breaking releases (beta.18, beta.23),descriptionfrontmatter filled in. Length scales with release size: big releases get 100–300 words, one-bullet releases get one honest sentence.3. Prompt refinements — the policies honed during this pass, folded back into the workflow prompt so future automated runs match:
descriptionspec (verb-led, under 140 characters).docs(site)— commitlint's scope-enum has nochangelogscope, so PRs opened by the workflow would have failed the commit check.Data fixes found along the way
compareUrl(beta.19...beta.19) — an off-by-one from the pipeline run racing the release cut. It now documents its actual change (fix(cli): correct bin path to match tsdown output #1337, the CLI bin-path fix) with the correct compare URL. All other 23compareUrls were verified against theCHANGELOG.mdfooter.Verification
descriptionchanged in every pre-existing file (plus the beta.19 correction above).astro syncpasses with no changelog collection errors.🤖 Generated with Claude Code
https://claude.ai/code/session_01G9r6aQkL82k4o3JqcfjkD3
Generated by Claude Code
Note
Low Risk
Documentation and workflow-prompt changes only; no player or package runtime code. Review focus is factual accuracy of prose and frontmatter, especially breaking-change migration text.
Overview
Backfills missing v10 beta changelog pages and replaces raw bullet lists with narrative prose across all 24
10.0.0-beta.*entries undersite/src/content/changelog/, including verb-leddescriptionfrontmatter for SEO/RSS.New or regenerated files cover gaps such as beta.1–6, beta.13, beta.20, and beta.21; existing entries are rewritten as paragraph-only stories that group related PRs, keep inline PR links, drop per-change author lines, and spell out migration guidance for breaking releases (notably beta.18 MediaHost and beta.23 cast/fullscreen renames). beta.19 is corrected: wrong pipeline content and a self-referencing
compareUrlare replaced with the CLI bin-path fix and the proper compare range.The
changelog-proseGitHub Actions prompt is updated so future automated runs match this pass: length scales with release size, internal-only releases get honest short copy, paragraphs-only formatting, contributor sections become a closing thanks, tighterdescriptionrules, and PR commits usedocs(site)for commitlint.Reviewed by Cursor Bugbot for commit f36033b. Bugbot is set up for automated code reviews on this repo. Configure here.