Skip to content

docs: keep the 0.5 stream format through 1.x, and say so - #467

Merged
anurag629 merged 1 commit into
devfrom
docs/keep-legacy-format
Oct 29, 2026
Merged

anurag629 merged 1 commit into
devfrom
docs/keep-legacy-format

Conversation

@anurag629

Copy link
Copy Markdown
Member

F4 of the 1.0 freeze, decided: the 0.5 stream format stays in 1.0 as the one documented exception, and goes in 2.0.

The plan was to drop it if the legacy counter on the docs site was near zero. It wasn't, but mostly because our own site loaded widget 0.4 until #459. We can't see other sites, and the format costs little to keep: toLegacyStream and one branch in the handler. Removing it would break every page with an old widget cached or pinned on a CDN.

  • The legacy_stream_format startup note, setup.mdx and the 0.5 upgrade guide now say through 1.x, not until 1.0.
  • The 1.0 upgrade guide opens with the exception, including regenerate: true, which those widgets send.
  • Patch changeset for @chatcops/server, since the logged message changed.

Tested: server tests, docs:check and lint pass.

@anurag629
anurag629 merged commit 3fada9b into dev Oct 29, 2026
5 checks passed
@anurag629
anurag629 deleted the docs/keep-legacy-format branch October 29, 2026 18:18
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