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: Add CSF 4 (experimental) snippets #30269

Draft
wants to merge 4 commits into
base: docs-csf-4
Choose a base branch
from

Conversation

kylegach
Copy link
Contributor

What I did

Add CSF 4 (experimental) versions of code snippets when react is the active renderer, using tabs:

CodeSnippet component with CSF 3 & CSF 4 (experimental) tabs

Checklist for Contributors

Testing

Manual testing

  1. Sync this branch with locally running docs site
  2. Manually confirm all updated snippets display as expected for both react and non-react renderers and for all languages (js, ts, ts-4-9)

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

  • 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.

@@ -1,3 +1,93 @@
```js filename="Button.stories.js" renderer="common" language="js" tabTitle="CSF 3"
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 diff is unfortunately hard to read. There are two required steps that aren't react-specific:

  1. common snippets must be placed before the react ones
  2. Add tabTitle="CSF 3" to common snippets

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The tags-in-preview.md diff is much easier to understand.

```

```js filename="Button.stories.js" renderer="svelte" language="js" tabTitle="CSF"
import Button from './Button.svelte';
<!-- js & ts-4-9 (when applicable) still needed while providing both CSF 3 & 4 -->
Copy link
Contributor Author

Choose a reason for hiding this comment

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

For the time being, we will need react versions of whatever languages are available for other renderers. In this case that means js, ts, and ts-4-9.

I left this comment in there for an easy find/replace once we only have CSF 4 snippets.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

If you think this is too much of a burden, I can try to adjust the snippets logic to only require one language for the CSF 4 snippets. But I anticipate that being quite tricky, and I'd rather do the "dumb" solution.

@kylegach kylegach force-pushed the docs-csf-4-snippets branch from d0371d2 to 6825384 Compare January 15, 2025 20:46
Copy link

nx-cloud bot commented Jan 15, 2025

View your CI Pipeline Execution ↗ for commit 5d7b457.

Command Status Duration Result
nx run-many -t build --parallel=3 ✅ Succeeded 4s View ↗

☁️ Nx Cloud last updated this comment at 2025-01-22 17:16:55 UTC

@kylegach kylegach self-assigned this Jan 15, 2025
* docs-csf-4: (45 commits)
  Improve clarity
  Stylistic preferences
  Stylistic preferences
  Remove unrelated CSF factory changes
  Docs: Fix syntax issues in documentation snippets
  Fix formatting
  Update yarn lock file
  Fix indentation
  Bump version from "8.6.0-alpha.0" to "8.6.0-alpha.1" [skip ci]
  Write changelog for 8.6.0-alpha.1 [skip ci]
  Replace `interaction test` -> `component test`
  Remove redundant browser configuration
  Update Vitest dependencies
  Add missing comma
  Addon Test: Support Vitest 3
  Angular: Fix typings
  disable flaky test-runner tests
  Revert "Refactor Vitest browser configuration"
  Fix tests
  RNWVite: Support for requires in rnw for images/fonts
  ...
@kylegach kylegach force-pushed the docs-csf-4-snippets branch from dd306eb to 5d7b457 Compare January 22, 2025 17:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants