Skip to content

Changelog: bring the 20.8.0 entries back to the house style - #1710

Open
obiot wants to merge 1 commit into
masterfrom
docs/changelog-20.8-tighten
Open

obiot wants to merge 1 commit into
masterfrom
docs/changelog-20.8-tighten

Conversation

@obiot

@obiot obiot commented Oct 3, 2026

Copy link
Copy Markdown
Member

The unreleased section had drifted badly:

release entries avg words
18.3.0 (what the convention points at) 53 21
19.9.0 35 26
20.5.0 / 20.6.0 / 20.7.0 23 / 3 / 19 ~50
20.8.0, before 28 97
20.8.0, after 24 24

The longest entry was 173 words. They had become design notes rather than
lines a reader scans to decide whether to upgrade.

Every entry is rewritten to one clause: the bold-name form 19.9.0 uses for
### Added, and a plain statement of the defect for ### Fixed. No em dashes.
Longest is now 36 words.

Moved

  • onOver returning false moves to Fixed. It is onOver honouring the
    contract onClick and onRelease already had, not a new capability
  • renderer.stroke() / fill() accepting a Sphere moves to Fixed.
    Sphere shipped in 19.7.0, so this was a two-version gap

Dropped

  • Color#setLinear. It exists because the glTF loader needed it; a game
    loading glTF does nothing differently for it. srgb.js was never on the
    barrel and linearToSrgb is @internal, so nothing public changed
  • RadialGradientEffect is exported. A missing export nobody was using

Merged

  • hdr and hdrOutput under one HDR rendering headline. The deeper
    caveats went with it: the 8-bytes-per-pixel target cost, that sprite chains
    stay 8-bit, the EXT_color_buffer_float requirement on WebGL2, and that
    "aces" clamps internally so it cannot feed hdrOutput. Those belong in the
    docs and the effects skill, not here. Easy to pull back if you disagree

Released sections are untouched; the diff is one hunk at lines 3 to 28.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NGvtaUNATVCVxD2qcbiY4t

The unreleased section had drifted to an average of 97 words an entry,
against 21 at 18.3.0 and 26 at 19.9.0, with the longest at 173. They had
become design notes rather than lines a reader scans to decide whether to
upgrade.

Every entry rewritten to one clause, 24 words on average and 36 at the
longest, with the bold-name form 19.9.0 uses for Added and a plain
statement of the defect for Fixed. No em dashes.

Also moved and dropped a few:

- `onOver` returning false moves to Fixed. It is `onOver` honouring the
  contract `onClick` and `onRelease` already had, not a new capability
- `renderer.stroke()` / `fill()` accepting a `Sphere` moves to Fixed.
  `Sphere` shipped in 19.7.0, so it was a two-version gap
- `Color#setLinear` dropped. It exists because the glTF loader needed it
  and no reader acts on it
- `RadialGradientEffect` dropped. A missing export nobody was using
- `hdr` and `hdrOutput` merged under one HDR rendering headline

Released sections are untouched.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NGvtaUNATVCVxD2qcbiY4t
Copilot AI balanced review requested due to automatic review settings October 3, 2026 08:26

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

This branch has not been deployed

No deployments
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.

2 participants