Skip to content

fix(changelog): treat public API refactors as user-facing in triage - #838

Merged
adrians5j merged 1 commit into
masterfrom
fix/changelog-triage-public-api
Oct 22, 2026
Merged

adrians5j merged 1 commit into
masterfrom
fix/changelog-triage-public-api

Conversation

@adrians5j

Copy link
Copy Markdown
Member

What changed

The first 6.6.0 regen with the triage from #837 marked 77 PRs as internal. Most were correct, but the list included refactors that change code Webiny users write against:

  • #5684, #5692, #5699, #5702, #5706: background task definitions split into metadata and a handler. Because #5684 was marked internal, its follow-ups #5709 to #5714 were hidden with it.
  • #5428: the ContextPlugin class is deleted.
  • #5969: upgrade to @webiny/di 2.0.
  • #5673: event handler routes get a name so they can be decorated.

TRIAGE_PROMPT treated "refactor with no visible effect" as internal and had no notion of a public API. It now says that Webiny users write extensions, event handlers, use cases, background tasks and DI implementations against Webiny's packages. A PR is user-facing, whatever its commit type, when it changes something that code imports, implements or receives. A refactor is internal only when everything it touches stays inside Webiny's packages.

The generation prompt gets the matching rule: such refactors get an entry, under ## Breaking Changes when project code has to change.

Testing

Prompt-only change. tsc and prettier pass. The effect shows on the next 6.6.0 regen once the Claude-made decisions in docs/release-notes/6.6.0/changelog.ai.txt are cleared on release/6.6.0, which is done separately on that branch.

Workspace: docs.webiny.com · changelog filtering and grouping

🤖 Generated with Claude Code

The 6.6.0 run marked refactor PRs that change what project code imports
or implements as internal, e.g. the background task handler shape
(#5684 and its follow-ups), removal of the ContextPlugin class (#5428)
and the @webiny/di 2.0 upgrade (#5969). Both prompts now say such
changes are user-facing, and breaking ones go under Breaking Changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs-webiny-com Ready Ready Preview Oct 22, 2026 11:02am UTC

Request Review

@adrians5j
adrians5j merged commit 4cb577c into master Oct 22, 2026
2 checks passed
@adrians5j
adrians5j deleted the fix/changelog-triage-public-api branch October 22, 2026 11:07

This branch was successfully deployed

1 active deployment
Preview — 22a11a0d Deployed Oct 22, 2026 by vercel[bot]
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