Skip to content

Rewrite release-2026-05 breaking changes & deprecations in AI-parsable format#1162

Open
ajwild wants to merge 1 commit into
trn-skills-breaking-deprecationsfrom
trn-2026-05-content
Open

Rewrite release-2026-05 breaking changes & deprecations in AI-parsable format#1162
ajwild wants to merge 1 commit into
trn-skills-breaking-deprecationsfrom
trn-2026-05-content

Conversation

@ajwild

@ajwild ajwild commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

What & why

Applies the AI-parsable TRN format to the Breaking Changes and Deprecations sections of release-2026-05, so an AI agent (or operator) can parse them into a concrete upgrade checklist.

Stacked on #1161 — base branch is trn-skills-breaking-deprecations (the skills + format reference). Review/merge that first; this PR's diff will shrink to just the content once it lands. Part of splitting up #1156.

Changes

  • 6 breaking changes + 4 deprecations rewritten into the Detect / Fix contract, with icon-free entry headings.
  • Greppable Detect lines — a literal token to search for (not an abstract dot-path), plus before/after tables for the path-rename entries.
  • **Code:** lines linking each entry to its LivingdocsBreakingChange / LivingdocsDeprecation log code, taken verbatim from the server source. Entries with no runtime code (direct lib/ imports, usage-log paramsSchema) correctly omit it.
  • ## Deprecations heading gains :warning:.
  • publicApi.executeDocumentCommands() moved from Features → Deprecations (it's an opt-in default-behaviour change, not a feature).
  • Redis: removal corrected to release-2026-09 (first announced release-2026-03), per LIDEP079.
  • Reserved dashboard handle casing fixed to imageCollections to match the server.

Notes

  • The commit uses fix() so semantic-release triggers a patch/deployment on merge.
  • The Features section is otherwise untouched — the full feature reformat is a separate, later change.

🤖 Generated with Claude Code

…arsable format

Apply the TRN format to the Breaking Changes and Deprecations sections:

- Detect/Fix sub-sections with greppable Detect lines (literal tokens, not
  abstract dot-paths) and before/after tables for path renames
- **Code:** lines linking entries to their LivingdocsBreakingChange /
  LivingdocsDeprecation log codes (verbatim from the server source)
- Icon-free entry headings; add ⚠️ to the Deprecations section heading
- Move publicApi.executeDocumentCommands() from Features to Deprecations
  (opt-in default-behaviour change)
- Redis: correct removal to release-2026-09 (first announced release-2026-03),
  per LIDEP079
- Fix the reserved dashboard handle casing to imageCollections

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

- `mediaLibrary.images.processing.maxFileSize` → `mediaLibrary.images.uploadRestrictions.maxFileSize`
- `mediaLibrary.images.uploadRestrictions.maxResolution` → `mediaLibrary.images.processing.maxResolution`
**Codes:** `LIBREAKING064-failOn`, `LIBREAKING064-convert`, `LIBREAKING064-lossy`, `LIBREAKING064-lossless`

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.

👏

@dfreier dfreier 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.

Fantastic! 🥳

What shall be the next steps to get CSO on board with this? Is something planned from E&S side?

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