Skip to content

docs(news): callouts for breaking changes and yanked releases - #1006

Merged
ajslater merged 1 commit into
developfrom
v0.3.3-news-callouts
Nov 6, 2026
Merged

ajslater merged 1 commit into
developfrom
v0.3.3-news-callouts

Conversation

@ajslater

@ajslater ajslater commented Nov 6, 2026

Copy link
Copy Markdown
Owner

Converts NEWS.md to the callout form from devenv's news_normalize.py (devenv #52). Only NEWS.md changes.

  • Wraps all 8 ### 💥 Breaking Changes sections in a > [!WARNING] callout: v2.3.1, v2.3.0, v2.0.0, v1.11.0, v1.10.0, v1.5.0, v0.8.0 and v0.7.0. v1.11.0's nested bullets stay nested inside the box.
  • Gives each of the 8 yanked or broken releases a one-sentence > [!CAUTION] body that says what was wrong and which release to use instead. v0.5.8, a working version bump, gets none.
  • v2.3.1 now says "read the 💥 Breaking Changes of every version since" instead of pointing at the Upgrading notes, a section that no longer exists.
  • Also normalizes two sub-group labels in v1.2.4 (- OPDS: and - Reader: lose their trailing colons), following the normalizer's existing rule.

Checked locally:

  • make fix and make lint pass.
  • The strict make docs build renders 8 admonition warning and 8 admonition caution boxes, with no literal [! left in the page.
  • A second normalizer run leaves the file byte-identical.

🤖 Generated with Claude Code

Wrap every 💥 Breaking Changes section in a > [!WARNING] callout and give
each yanked or broken release a > [!CAUTION] body naming the release to use
instead, via devenv's news_normalize.py. Also point v2.3.1 at the
💥 Breaking Changes sections instead of the long-gone Upgrading notes, and
normalize two sub-group labels in v1.2.4.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ajslater
ajslater merged commit 2fb0484 into develop Nov 6, 2026
2 checks passed
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