Docs: Enhance upgrading guide#31744
Merged
Merged
Conversation
…tic health check features
valentinpalkovic
added
documentation
ci:docs
valentinpalkovic
requested review from
jonniebigodes and
kylegach
as code owners
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
1 file reviewed, 1 comment
Edit PR Review Bot Settings | Greptile
yannbf
reviewed
Jun 11, 2025
yannbf
reviewed
Jun 11, 2025
Co-authored-by: Yann Braga <yannbf@gmail.com>
yannbf
reviewed
Jun 11, 2025
yannbf
reviewed
Jun 11, 2025
yannbf
reviewed
Jun 11, 2025
|
View your CI Pipeline Execution ↗ for commit 6e1fac0.
☁️ Nx Cloud last updated this comment at |
Co-authored-by: Yann Braga <yannbf@gmail.com>
Co-authored-by: Yann Braga <yannbf@gmail.com>
…ection in upgrading guide
* next: (39 commits) Update CHANGELOG.md for v9.0.9 [skip ci] fix scripts test Next.js: Add styled-jsx to optimize Vite dependencies in configuration Next.js: Update styled-jsx resolution method in Vite configuration Prevent destructuring of undefined Next.js: Enhance Vite configuration with styled-jsx aliasing Next.js: Add webpack alias to resolve Next.js package conflicts dont at-mention users in release PR descriptions cleanup, fix unit tests Angular: Update MiniCssExtractPlugin configuration for cache busting remove unneeded preview entrypoints for core addons relatively import preview annotations of core addons Refactor import statements in find-implicit-spies.ts to consolidate Babel imports Update dependencies in yarn.lock and package.json use babel from core in codemods bundle in giget Bump version from "9.1.0-alpha.5" to "9.1.0-alpha.6" [skip ci] prebundle more in cli-storybook package Write changelog for 9.1.0-alpha.6 [skip ci] fix package manager instance in empty dir flow ...
kylegach
added
the
patch:yes
jonniebigodes
approved these changes
Jun 13, 2025
Contributor
jonniebigodes
left a comment
jonniebigodes
left a comment
There was a problem hiding this comment.
@valentinpalkovic, thanks for putting together this pull request and helping improve the documentation. I appreciate it 🙏 ! I left one item for you to consider when you can.
Approving to unblock you
Comment on lines
+101
to
+112
| | Flag | Description | | ||
| | -------------------------------- | ------------------------------------------------------------------------------------------ | | ||
| | `-c, --config-dir <dir-name...>` | Directory or directories to find Storybook configurations | | ||
| | `--debug` | Enable more logs for debugging (default: false) | | ||
| | `--disable-telemetry` | Disable sending telemetry data | | ||
| | `--enable-crash-reports` | Enable sending crash reports to telemetry data | | ||
| | `-f, --force` | Force the upgrade, skipping autoblockers | | ||
| | `--loglevel <level>` | Define log level: `debug`, `error`, `info`, `silent`, `trace`, or `warn` (default: `info`) | | ||
| | `--package-manager <manager>` | Force package manager: `npm`, `pnpm`, `yarn1`, `yarn2`, or `bun` | | ||
| | `-s, --skip-check` | Skip postinstall version and automigration checks | | ||
| | `--write-logs` | Write all debug logs to a file at the end of the run | | ||
| | `-y, --yes` | Skip prompting the user | |
Contributor
There was a problem hiding this comment.
@valentinpalkovic, when you can, adjust the upgrade options in the CLI documentation with the new ones (e.g., --write-logs and --loglevel <level>) so that we don't introduce misconceptions in the documentation
This was referenced Jun 16, 2025
Merged
valentinpalkovic
added
patch:yes
Merged
15 tasks
valentinpalkovic
added a commit
that referenced
this pull request
Jun 18, 2025
…cumentation Docs: Enhance upgrading guide (cherry picked from commit d6e6437)
Closed
15 tasks
github-actions
Bot
added
the
patch:done
ndelangen
removed
the
patch:yes
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #
What I did
Enhance the upgrading guide with mono-repository support and automatic health check features
Checklist for Contributors
Testing
The changes in this PR are covered in the following automated tests:
Manual testing
This section is mandatory for all contributions. If you believe no manual test is necessary, please state so explicitly. Thanks!
Documentation
MIGRATION.MD
Checklist for Maintainers
When this PR is ready for testing, make sure to add
ci:normal,ci:mergedorci:dailyGH label to it to run a specific set of sandboxes. The particular set of sandboxes can be found incode/lib/cli-storybook/src/sandbox-templates.tsMake 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
This PR does not have a canary release associated. You can request a canary release of this pull request by mentioning the
@storybookjs/coreteam here.core team members can create a canary release here or locally with
gh workflow run --repo storybookjs/storybook canary-release-pr.yml --field pr=<PR_NUMBER>Greptile Summary
Comprehensive enhancement of the upgrading documentation, adding detailed sections on mono-repository support and automated health checks.
doctorcommand documentation for automated health checks and troubleshooting