Skip to content

Docs: Update SB11 migration notes for CSF tools - #36322

Merged
valentinpalkovic merged 1 commit into
nextfrom
agent/sto-352-migration-refresh
Sep 18, 2026
Merged

valentinpalkovic merged 1 commit into
nextfrom
agent/sto-352-migration-refresh

Conversation

@valentinpalkovic

Copy link
Copy Markdown
Contributor

Closes #

What I did

  • Audited all pull requests merged between 2026-09-13 08:00 UTC and 2026-09-15 08:00 UTC. Nine landed on next; one landed on an experimental side branch.
  • Documented the migration from the removed ConfigFile helpers in CSF: Add shared mutation API for stories and config files #36248 to the unified CsfObject API.
  • Added the internal tooling change to the Storybook 11 migration guide. The remaining audited merges are fixes, tests, CI cleanup, documentation restructuring, or internal moves with no user migration step.

Checklist for Contributors

Testing

The changes in this PR are covered in the following automated tests:

  • stories
  • unit tests
  • integration tests
  • end-to-end tests

Manual testing

Caution

This section is mandatory for all contributions. If you believe no manual test is necessary, please state so explicitly. Thanks!

  1. Run yarn docs:check from the repository root and expect Docs check: no errors found.
  2. Open docs/releases/migration-guide.mdx and follow the new Update custom CSF tooling to the unified mutation API link. Confirm it reaches the matching section in MIGRATION.md.
  3. Compare the replacement table with code/core/src/csf-tools/ConfigFile.ts. Confirm that each Storybook 11 method and type exists and that the removed Storybook 10 names do not.

Documentation

  • Add or update documentation reflecting your changes
  • If you are deprecating/removing a feature, make sure to update
    MIGRATION.MD

Checklist for Maintainers

  • When this PR is ready for testing, make sure to add ci:normal, ci:merged or ci:daily GH label to it to run a specific set of sandboxes. The particular set of sandboxes can be found in code/lib/cli-storybook/src/sandbox-templates.ts

  • Declare whether manual QA will be needed for this PR during the next release, through qa:needed or qa:skip

  • Make sure this PR contains one of the labels below:

    Available labels
    • bug: Internal changes that fixes incorrect behavior.
    • maintenance: User-facing maintenance tasks.
    • dependencies: Upgrading (sometimes downgrading) dependencies.
    • build: Internal-facing build tooling & test updates. Will not show up in release changelog.
    • cleanup: Minor cleanup style change. Will not show up in release changelog.
    • documentation: Documentation only changes. Will not show up in release changelog.
    • feature request: Introducing a new feature.
    • BREAKING CHANGE: Changes that break compatibility in some way with current major version.
    • other: Changes that don't fit in the above categories.

🦋 Canary Release - 🚫 Not run

This PR does not have a canary release associated.

In-repo PRs: add the ci:canary label. Later pushes republish while the label remains.

Fork PRs: the label does nothing (a later push must not auto-publish). A maintainer publishes from this repository with Run workflow and the pr input. branch and sha are optional; if more than one is set, they must be the same commit. The fork author does not need to do anything.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
@valentinpalkovic valentinpalkovic added documentation ci:docs Run the CI jobs for documentation checks only. qa:skip Pull Requests that do not need any QA. (e.g. documentation) labels Sep 15, 2026
@valentinpalkovic
valentinpalkovic marked this pull request as ready for review September 18, 2026 11:31
@valentinpalkovic valentinpalkovic self-assigned this Sep 18, 2026
@coderabbitai

coderabbitai Bot commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

Review Change StackReview Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Essentials

Run ID: 6a9c7037-acf2-4052-a30e-ecc7b16d68e6

📥 Commits

Reviewing files that changed from the base of the PR and between 06dc54c and c17f439.

📒 Files selected for processing (2)
  • MIGRATION.md
  • docs/releases/migration-guide.mdx

Included review availability: Your plan provides up to 10 included reviews per hour; 8 remain after this review.


Walkthrough

The migration documentation adds Storybook 11 guidance for custom CSF tooling. It describes replacing ConfigFile helpers with CsfObject methods and handling resolution results, mutation diagnostics, and writeConfig validation.

Changes

CSF tooling migration

Layer / File(s) Summary
Unified mutation API guidance
MIGRATION.md, docs/releases/migration-guide.mdx
The documentation lists the migration entry and describes replacing legacy helpers with getValue, set, and callArguments. It also documents mutation results, diagnostics, unresolved values, and writeConfig validation.

Priority: ⬇️ Low

Merge Risk: ⚪ Minimal · up to c17f4

The migration guidance changes do not introduce an identified production or user-facing risk and are ready to merge.


Comment @coderabbitai help to get the list of available commands.

@valentinpalkovic
valentinpalkovic merged commit 1e5ff76 into next Sep 18, 2026
38 of 43 checks passed
@valentinpalkovic
valentinpalkovic deleted the agent/sto-352-migration-refresh branch September 18, 2026 19:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci:docs Run the CI jobs for documentation checks only. documentation qa:skip Pull Requests that do not need any QA. (e.g. documentation)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants