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: Document portable stories usage #28452

Merged
merged 9 commits into from
Jul 10, 2024
Merged

Conversation

yannbf
Copy link
Member

@yannbf yannbf commented Jul 4, 2024

Closes #

What I did

Followup of #28444, this enables documentation pages for portable stories and adds usage for the new format (via the play function)

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

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

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>

@yannbf yannbf added documentation ci:docs Run the CI jobs for documentation checks only. portable stories labels Jul 4, 2024
Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

PR Summary

  • Simplified Jest test examples by combining rendering and play function execution (docs/_snippets/portable-stories-jest-with-play-function.md)
  • Deleted Vitest with loaders example file, suggesting documentation restructuring (docs/_snippets/portable-stories-vitest-with-loaders.md)
  • Updated Vitest documentation to combine rendering and play function steps (docs/_snippets/portable-stories-vitest-with-play-function.md)
  • Renamed and updated file to include testingLibraryRender in setProjectAnnotations (docs/_snippets/storybook-testing-addon-set-annotations.md)
  • Enhanced Jest documentation with detailed setup and usage instructions (docs/api/portable-stories/portable-stories-jest.mdx)

9 file(s) reviewed, 2 comment(s)
Edit PR Review Bot Settings

@@ -78,8 +76,8 @@ sidebar:

```ts
// Button.stories.portable.ts
// Replace <your-renderer> with your renderer, e.g. react, vue3
import { composeStories } from '@storybook/<your-renderer>';
// Replace your-renderer with the renderer you are using (e.g. react, vue3)
Copy link
Contributor

Choose a reason for hiding this comment

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

🪶 style: Consider using backticks for your-renderer to maintain consistency with other code comments.

// Replace <your-renderer> with your renderer, e.g. react, vue3
import { setProjectAnnotations } from '@storybook/<your-renderer>';
// Replace your-renderer with the renderer you are using (e.g. react, vue3)
import { setProjectAnnotations } from '@storybook/your-renderer';
Copy link
Contributor

Choose a reason for hiding this comment

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

🪶 style: Consider using backticks for your-renderer to maintain consistency with other code comments.

Copy link

nx-cloud bot commented Jul 4, 2024

☁️ Nx Cloud Report

CI is running/has finished running commands for commit 4ae680c. 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.

@@ -13,20 +13,24 @@ draft: true
{/* End non-supported renderers */}
</If>

<If renderer="svelte">
(⚠️ **Experimental**)
Copy link
Member Author

Choose a reason for hiding this comment

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

@shilman @vanessayuenn FYI we are adding this to svelte specifically, as the API might need some extra work

@kylegach kylegach merged commit 5ef80be into next Jul 10, 2024
11 checks passed
@kylegach kylegach deleted the yann/document-portable-stories branch July 10, 2024 19:09
kylegach added a commit that referenced this pull request Jul 10, 2024
…ries

Docs: Document portable stories usage
@github-actions github-actions bot mentioned this pull request Jul 10, 2024
33 tasks
@kylegach kylegach mentioned this pull request Jul 10, 2024
4 tasks
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 portable stories
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants