Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Update build Storybook references #28271

Merged

Conversation

ahayes91
Copy link
Contributor

What I did

I noticed some documentation today (specifically this page) still refers to the build-storybook command, which was removed in v7 (https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#start-storybook--build-storybook-binaries-removed) in this PR.
This confused me for a bit, so let's fix that 😏
I figured I may as well submit a PR updating a bunch of those places and maybe some more that seemed reasonable, but feel free to suggest changes I should remove for any reason!

start-storybook doesn't seem to be mentioned as much in the docs anymore from what I can tell 💪

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

N/A

Manual testing

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

N/A unless anyone has suggestions otherwise

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/src/sandbox-templates.ts

  • 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

This PR does not have a canary release associated. You can request a canary release of this pull request by mentioning the @storybookjs/core team 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>

@ahayes91 ahayes91 marked this pull request as ready for review June 18, 2024 16:00
@jonniebigodes jonniebigodes self-assigned this Jun 18, 2024
@jonniebigodes jonniebigodes added ci: do not merge documentation ci:docs Run the CI jobs for documentation checks only. labels Jun 18, 2024
Copy link
Contributor

@jonniebigodes jonniebigodes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ahayes91 thank you so much for putting together this pull request and helping us improve our documentation by updating the contents and examples we provide. We appreciate it 🙏 ! Left some items for you to look into when you have a moment.

Let me know of any questions you may have regarding it so that I'm able to follow up with you on them.

Looking forward to hearing from you.

Hope you have a fantastic day.

Stay safe

docs/_snippets/build-storybook-production-mode.md Outdated Show resolved Hide resolved
docs/_snippets/ghp-github-action.md Outdated Show resolved Hide resolved
docs/_snippets/storybook-build-test-flag.md Outdated Show resolved Hide resolved
docs/_snippets/storybook-debug-webpack-prod.md Outdated Show resolved Hide resolved
docs/_snippets/test-runner-local-build-workflow.md Outdated Show resolved Hide resolved
@@ -72,7 +72,7 @@ Then you can access this environment variable anywhere, even within your stories
You can also use specific files for specific modes. Add a `.env.development` or `.env.production` to apply different values to your environment variables.
</Callout>

You can also pass these environment variables when you are [building your Storybook](../sharing/publish-storybook.mdx) with `build-storybook`.
You can also pass these environment variables when you are [building your Storybook](../sharing/publish-storybook.mdx) with `storybook build`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same goes here. In this context we're aiming for the script as well

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is actually the page and the line that confused me as a passive Storybook user, and kicked off opening this whole PR 😂
I will make all the changes you have suggested, but maybe there is another improvement that we can make that can be explicit about when build-storybook is available and when it isn't, because reading the migration guide makes it seem like it is not available anymore https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#start-storybook--build-storybook-binaries-removed

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for pointing that out. We can improve that portion of the documentation to avoid any confusion you or any other Storybook user may have.

docs/api/main-config/main-config-build.mdx Outdated Show resolved Hide resolved
docs/api/main-config/main-config-build.mdx Outdated Show resolved Hide resolved
docs/writing-docs/build-documentation.mdx Outdated Show resolved Hide resolved
Copy link

nx-cloud bot commented Jul 22, 2024

☁️ Nx Cloud Report

CI is running/has finished running commands for commit f2b5884. As they complete they will appear below. Click to see the status, the terminal output, and the build insights.

📂 See all runs for this CI Pipeline Execution


✅ Successfully ran 1 target

Sent with 💌 from NxCloud.

@jonniebigodes jonniebigodes changed the title Update a bunch of references to build-storybook command in the docs to storybook build Docs: Update build Storybook references Jul 22, 2024
@ahayes91
Copy link
Contributor Author

Thank you @jonniebigodes for reviewing! I must admit I forgot about this PR 😅

@jonniebigodes
Copy link
Contributor

@ahayes91, thanks for addressing the feedback so promptly. I appreciate it 🙏 ! And don't worry about it. It's been some busy weeks here at Storybook, and I was also unable to do a review of this pull request.

All is good on my end. I'm going to merge this once the checklist clears.

Hope you have an amazing day.

Stay safe

@jonniebigodes jonniebigodes merged commit 17e26a7 into storybookjs:next Jul 24, 2024
9 checks passed
@ahayes91 ahayes91 deleted the docs-build-storybook-references branch July 24, 2024 16:10
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
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants