Skip to content

docs: split the 8.0 / 8.1 release narratives, and backfill three missing changelog entries - #2010

Merged
jcschaff merged 3 commits into
masterfrom
docs/backfill-8.0.3-8.0.4-changelog
Aug 21, 2026
Merged

docs: split the 8.0 / 8.1 release narratives, and backfill three missing changelog entries#2010
jcschaff merged 3 commits into
masterfrom
docs/backfill-8.0.3-8.0.4-changelog

Conversation

@jcschaff

@jcschaff jcschaff commented Aug 21, 2026

Copy link
Copy Markdown
Member

What this does

Two related documentation problems, both found while summarizing what changed across the 8.0 line.

1. Three releases were never written up

8.0.3.01, 8.0.3.02 and 8.0.4.01 were tagged and deployed on 2026-07-29 but have no CHANGELOG.md entry — the file jumps from 8.0.2.07 to 8.0.5.01.

The gap hides a whole feature. The SpringSaLaD 3D trajectory viewer arrived in 8.0.3.02 (#1795/#1796/#1797) and reached remotely-run simulations in 8.0.4.01 (#1798). Everything the changelog did say about the viewer was a later refinement, so reading it end to end, the viewer appeared never to have shipped.

Entries were written from each PR's diff, not its title. Three came out differently as a result:

2. The 8.0 narrative had absorbed three months of 8.1 work

For release notes and announcements, VCell 8.0 is the 8.0.0 builds — 8.0.0.01 through 8.0.0.03, the SpringSaLaD GA that ran in production from 2026-05-21 to 2026-08-14. Everything after 8.0.0.03 is VCell 8.1, which reached production on 2026-08-14 and is still accumulating.

Published build numbers are untouched. This is a narrative boundary, not a renumbering — 8.1 is delivered by builds numbered 8.0.x, and both documents say so.

release-notes/major/8.0.0.md had been accumulating every build since the GA, so it credited 8.0 with a viewer, an import overhaul and two dozen fixes that no 8.0.0 build contained. All 26 of its bug-fix bullets were annotated 8.0.5.01 or later — the boundary showing itself.

Changes

File
CHANGELOG.md the three missing entries, in house format
release-notes/major/8.0.md renamed from 8.0.0.md, trimmed to 8.0.0.x content
release-notes/major/8.1.md new — the 8.0.2.01 → 8.0.28.01 narrative
docs/RELEASING.md records that narrative name and build version may differ, and which file a cut appends to
7.7-*.md, docs/backlog/01-close-and-verify.md reference updates for the rename

Verification

  • No tracked reference to 8.0.0.md remains.
  • Changelog entries are in descending version order between 8.0.5.01 and 8.0.2.07; dates taken from the tag objects.
  • 8.1 bug fixes sorted by build version (29 bullets).
  • git merge-base --is-ancestor confirms the viewer commit is not in 8.0.0.03.
  • LF endings preserved, no trailing whitespace, wrap width matches neighbours.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FUd61NUJgz88h4PZs5MqHn

… entries

Three releases were tagged and deployed but never written up, so the
changelog jumps from 8.0.2.07 straight to 8.0.5.01. The gap hides the
arrival of the SpringSaLaD 3D trajectory viewer (8.0.3.02) and the fix
that made it reach remotely-run simulations (8.0.4.01) — reading the
changelog, the viewer appears never to have shipped at all.

Entries are reconstructed from the diffs of the merged PRs rather than
from their titles: #1745, #1784, #1787, #1788, #1789/#1790/#1791 for
8.0.3.01; #1795, #1796, #1797 for 8.0.3.02; #1798 for 8.0.4.01.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FUd61NUJgz88h4PZs5MqHn
@jcschaff
jcschaff force-pushed the docs/backfill-8.0.3-8.0.4-changelog branch from f9e3301 to 264a85d Compare August 21, 2026 12:52
jcschaff and others added 2 commits August 21, 2026 09:03
For release notes and user-facing announcements, VCell 8.0 is the 8.0.0
builds — 8.0.0.01 through 8.0.0.03, the SpringSaLaD GA that ran on the
production site from 2026-05-21 to 2026-08-14. Everything released after
it belongs to VCell 8.1, which reached production on 2026-08-14 and is
still accumulating. Published build numbers are unchanged; this is a
narrative boundary, not a renumbering.

The 8.0 document had been accumulating every 8.0.x build since the GA,
so it credited 8.0 with a viewer, an import overhaul and two dozen fixes
that no 8.0.0 build ever contained. Those move to the new 8.1 document —
all 26 of its bug-fix bullets were annotated 8.0.5.01 or later, which is
the boundary showing itself.

Also renames 8.0.0.md to 8.0.md to match the narrative name, and updates
the references in the 7.7 documents and the backlog note.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FUd61NUJgz88h4PZs5MqHn
…iffer

Nothing in the procedure said which narrative file a release cut should
append to, and the obvious guess — the one matching the build's
MAJOR.MINOR — is now wrong: 8.0.28.01 is VCell 8.1 work. Says so, and
says CHANGELOG.md is unaffected because it is organised by build.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FUd61NUJgz88h4PZs5MqHn
@jcschaff
jcschaff force-pushed the docs/backfill-8.0.3-8.0.4-changelog branch from 264a85d to ec3295a Compare August 21, 2026 13:03
@jcschaff jcschaff changed the title docs: backfill the missing 8.0.3.01 / 8.0.3.02 / 8.0.4.01 changelog entries docs: split the 8.0 / 8.1 release narratives, and backfill three missing changelog entries Aug 21, 2026
@jcschaff
jcschaff merged commit d896d2c into master Aug 21, 2026
7 checks passed
@jcschaff
jcschaff deleted the docs/backfill-8.0.3-8.0.4-changelog branch August 21, 2026 13:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant