From fea8bb5a25ddd5eceb40ca0939fee911dac586f9 Mon Sep 17 00:00:00 2001
From: Kyle Gach <kyle.gach@gmail.com>
Date: Mon, 29 Jan 2024 14:03:30 -0700
Subject: [PATCH 1/7] Fix bad docs paths

---
 docs/api/index.md      | 2 +-
 docs/api/parameters.md | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/api/index.md b/docs/api/index.md
index 168f0d0456a4..60edd614c32c 100644
--- a/docs/api/index.md
+++ b/docs/api/index.md
@@ -82,7 +82,7 @@ An overview of all available API references for Storybook.
     <tr>
       <td><a href="../api/parameters">Parameters</a></td>
       <td>
-        Parameters are static metadata used to configure your <a href="../get-started/whats-a-story.md">stories</a> <a href="../addons/introduction.md">addons</a> in Storybook. They are specified at the story, meta (component), project (global) levels.
+        Parameters are static metadata used to configure your <a href="../get-started/whats-a-story.md">stories</a> <a href="../addons/index.md">addons</a> in Storybook. They are specified at the story, meta (component), project (global) levels.
       </td>
     </tr>
   </tbody>
diff --git a/docs/api/parameters.md b/docs/api/parameters.md
index 53174e387492..70c555c61783 100644
--- a/docs/api/parameters.md
+++ b/docs/api/parameters.md
@@ -2,7 +2,7 @@
 title: 'Parameters'
 ---
 
-Parameters are static metadata used to configure your [stories](../get-started/whats-a-story.md) and [addons](../addons/introduction.md) in Storybook. They are specified at the story, meta (component), project (global) levels.
+Parameters are static metadata used to configure your [stories](../get-started/whats-a-story.md) and [addons](../addons/index.md) in Storybook. They are specified at the story, meta (component), project (global) levels.
 
 ## Story parameters
 
@@ -36,7 +36,7 @@ Parameters specified at the story level apply to that story only. They are defin
 
 </div>
 
-Parameter's specified in a [CSF](../writing-stories/introduction.md#component-story-format-csf) file's meta configuration apply to all stories in that file. They are defined in the `parameters` property of the `meta` (default export):
+Parameter's specified in a [CSF](../writing-stories/index.md#component-story-format-csf) file's meta configuration apply to all stories in that file. They are defined in the `parameters` property of the `meta` (default export):
 
 <!-- prettier-ignore-start -->
 

From 8ab95188f9ce9a79c251dacd4675f4f8084d6e2c Mon Sep 17 00:00:00 2001
From: Kyle Gach <kyle.gach@gmail.com>
Date: Mon, 29 Jan 2024 14:06:52 -0700
Subject: [PATCH 2/7] Re-document subcomponents

- Largely reverted relevant portions of #20233 & #21742
---
 .../list-story-with-subcomponents.ts.mdx      |  50 ++++++++++++++++++
 .../common/subcomponents-in-meta.js.mdx       |  10 ++++
 .../common/subcomponents-in-meta.ts-4-9.mdx   |  15 ++++++
 .../common/subcomponents-in-meta.ts.mdx       |  15 ++++++
 .../list-story-with-subcomponents.js.mdx      |  28 ++++++++++
 .../list-story-with-subcomponents.ts-4-9.mdx  |  32 +++++++++++
 .../list-story-with-subcomponents.ts.mdx      |  31 +++++++++++
 .../vue/list-story-with-sub-components.js.mdx |  35 ++++++++++++
 .../list-story-with-sub-components.ts-4-9.mdx |  41 ++++++++++++++
 .../vue/list-story-with-sub-components.ts.mdx |  41 ++++++++++++++
 .../list-story-with-subcomponents.js.mdx      |  21 ++++++++
 .../list-story-with-subcomponents.ts.mdx      |  26 +++++++++
 docs/writing-docs/autodocs.md                 |  23 ++++++++
 .../doc-block-arg-types-subcomponents.png     | Bin 0 -> 10007 bytes
 ...block-arg-types-subcomponents-for-list.png | Bin 0 -> 16815 bytes
 .../stories-for-multiple-components.md        |  33 +++++++++++-
 16 files changed, 399 insertions(+), 2 deletions(-)
 create mode 100644 docs/snippets/angular/list-story-with-subcomponents.ts.mdx
 create mode 100644 docs/snippets/common/subcomponents-in-meta.js.mdx
 create mode 100644 docs/snippets/common/subcomponents-in-meta.ts-4-9.mdx
 create mode 100644 docs/snippets/common/subcomponents-in-meta.ts.mdx
 create mode 100644 docs/snippets/react/list-story-with-subcomponents.js.mdx
 create mode 100644 docs/snippets/react/list-story-with-subcomponents.ts-4-9.mdx
 create mode 100644 docs/snippets/react/list-story-with-subcomponents.ts.mdx
 create mode 100644 docs/snippets/vue/list-story-with-sub-components.js.mdx
 create mode 100644 docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
 create mode 100644 docs/snippets/vue/list-story-with-sub-components.ts.mdx
 create mode 100644 docs/snippets/web-components/list-story-with-subcomponents.js.mdx
 create mode 100644 docs/snippets/web-components/list-story-with-subcomponents.ts.mdx
 create mode 100644 docs/writing-docs/doc-block-arg-types-subcomponents.png
 create mode 100644 docs/writing-stories/doc-block-arg-types-subcomponents-for-list.png

diff --git a/docs/snippets/angular/list-story-with-subcomponents.ts.mdx b/docs/snippets/angular/list-story-with-subcomponents.ts.mdx
new file mode 100644
index 000000000000..17e8ab2e60aa
--- /dev/null
+++ b/docs/snippets/angular/list-story-with-subcomponents.ts.mdx
@@ -0,0 +1,50 @@
+```ts
+// List.stories.ts
+
+import type { Meta, StoryObj } from '@storybook/angular';
+
+import { moduleMetadata } from '@storybook/angular';
+
+import { CommonModule } from '@angular/common';
+
+import { List } from './list.component';
+import { ListItem } from './list-item.component';
+
+const meta: Meta<List> = {
+  /* 👇 The title prop is optional.
+   * See https://storybook.js.org/docs/7.0/angular/configure/overview#configure-story-loading
+   * to learn how to generate automatic titles
+   */
+  title: 'List',
+  component: List,
+  subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
+  decorators: [
+    moduleMetadata({
+      declarations: [List, ListItem],
+      imports: [CommonModule],
+    }),
+  ],
+};
+
+export default meta;
+type Story = StoryObj<List>;
+
+/*
+ *👇 Render functions are a framework specific feature to allow you control on how the component renders.
+ * See https://storybook.js.org/docs/7.0/angular/api/csf
+ * to learn how to use render functions.
+ */
+export const Empty: Story = {};
+
+export const OneItem: Story = {
+  args: {},
+  render: (args) => ({
+    props: args,
+    template: `
+      <app-list>
+        <app-list-item></app-list-item>
+      </app-list>
+  `,
+  }),
+};
+```
diff --git a/docs/snippets/common/subcomponents-in-meta.js.mdx b/docs/snippets/common/subcomponents-in-meta.js.mdx
new file mode 100644
index 000000000000..c925367d0b09
--- /dev/null
+++ b/docs/snippets/common/subcomponents-in-meta.js.mdx
@@ -0,0 +1,10 @@
+```js
+// ButtonGroup.stories.js|jsx
+
+import { Button, ButtonGroup } from './ButtonGroup';
+
+export default {
+  component: ButtonGroup,
+  subcomponents: { Button },
+};
+```
diff --git a/docs/snippets/common/subcomponents-in-meta.ts-4-9.mdx b/docs/snippets/common/subcomponents-in-meta.ts-4-9.mdx
new file mode 100644
index 000000000000..49f5deefb5ca
--- /dev/null
+++ b/docs/snippets/common/subcomponents-in-meta.ts-4-9.mdx
@@ -0,0 +1,15 @@
+```ts
+// ButtonGroup.stories.ts|tsx
+
+// Replace your-framework with the name of your framework
+import type { Meta, StoryObj } from '@storybook/your-framework';
+
+import { Button, ButtonGroup } from './ButtonGroup';
+
+const meta = {
+  component: ButtonGroup,
+  subcomponents: { Button },
+} satisfies Meta<typeof Button>;
+
+export default meta;
+```
\ No newline at end of file
diff --git a/docs/snippets/common/subcomponents-in-meta.ts.mdx b/docs/snippets/common/subcomponents-in-meta.ts.mdx
new file mode 100644
index 000000000000..8847609e9fac
--- /dev/null
+++ b/docs/snippets/common/subcomponents-in-meta.ts.mdx
@@ -0,0 +1,15 @@
+```ts
+// ButtonGroup.stories.ts|tsx
+
+// Replace your-framework with the name of your framework
+import type { Meta } from '@storybook/your-framework';
+
+import { Button, ButtonGroup } from './ButtonGroup';
+
+const meta: Meta<typeof ButtonGroup> = {
+  component: ButtonGroup,
+  subcomponents: { Button },
+};
+
+export default meta;
+```
\ No newline at end of file
diff --git a/docs/snippets/react/list-story-with-subcomponents.js.mdx b/docs/snippets/react/list-story-with-subcomponents.js.mdx
new file mode 100644
index 000000000000..1bae39ac9a4e
--- /dev/null
+++ b/docs/snippets/react/list-story-with-subcomponents.js.mdx
@@ -0,0 +1,28 @@
+```js
+// List.stories.js|jsx
+
+import React from 'react';
+
+import { List } from './List';
+import { ListItem } from './ListItem';
+
+export default {
+  /* 👇 The title prop is optional.
+   * See https://storybook.js.org/docs/7.0/react/configure/overview#configure-story-loading
+   * to learn how to generate automatic titles
+   */
+  title: 'List',
+  component: List,
+  subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
+};
+
+export const Empty = {};
+
+export const OneItem = {
+  render: (args) => (
+    <List {...args}>
+      <ListItem />
+    </List>
+  ),
+};
+```
diff --git a/docs/snippets/react/list-story-with-subcomponents.ts-4-9.mdx b/docs/snippets/react/list-story-with-subcomponents.ts-4-9.mdx
new file mode 100644
index 000000000000..71abc96d3c2c
--- /dev/null
+++ b/docs/snippets/react/list-story-with-subcomponents.ts-4-9.mdx
@@ -0,0 +1,32 @@
+```ts
+// List.stories.ts|tsx
+
+import type { Meta, StoryObj } from '@storybook/react';
+
+import { List } from './List';
+import { ListItem } from './ListItem';
+
+const meta = {
+  /* 👇 The title prop is optional.
+   * See https://storybook.js.org/docs/7.0/react/configure/overview#configure-story-loading
+   * to learn how to generate automatic titles
+   */
+  title: 'List',
+  component: List,
+  //👈 Adds the ListItem component as a subcomponent
+  subcomponents: { ListItem },
+} satisfies Meta<typeof List>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Empty: Story = {};
+
+export const OneItem: Story = {
+  render: (args) => (
+    <List {...args}>
+      <ListItem />
+    </List>
+  ),
+};
+```
diff --git a/docs/snippets/react/list-story-with-subcomponents.ts.mdx b/docs/snippets/react/list-story-with-subcomponents.ts.mdx
new file mode 100644
index 000000000000..dcb959020f98
--- /dev/null
+++ b/docs/snippets/react/list-story-with-subcomponents.ts.mdx
@@ -0,0 +1,31 @@
+```tsx
+// List.stories.ts|tsx
+
+import type { Meta, StoryObj } from '@storybook/react';
+
+import { List } from './List';
+import { ListItem } from './ListItem';
+
+const meta: Meta<typeof List> = {
+  /* 👇 The title prop is optional.
+   * See https://storybook.js.org/docs/7.0/react/configure/overview#configure-story-loading
+   * to learn how to generate automatic titles
+   */
+  title: 'List',
+  component: List,
+  subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
+};
+
+export default meta;
+type Story = StoryObj<typeof List>;
+
+export const Empty: Story = {};
+
+export const OneItem: Story = {
+  render: (args) => (
+    <List {...args}>
+      <ListItem />
+    </List>
+  ),
+};
+```
diff --git a/docs/snippets/vue/list-story-with-sub-components.js.mdx b/docs/snippets/vue/list-story-with-sub-components.js.mdx
new file mode 100644
index 000000000000..9d674dbfebf4
--- /dev/null
+++ b/docs/snippets/vue/list-story-with-sub-components.js.mdx
@@ -0,0 +1,35 @@
+```js
+// List.stories.js
+
+import List from './List.vue';
+import ListItem from './ListItem.vue';
+
+export default {
+  /* 👇 The title prop is optional.
+   * See https://storybook.js.org/docs/7.0/vue/configure/overview#configure-story-loading
+   * to learn how to generate automatic titles
+   */
+  title: 'List',
+  component: List,
+  subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
+};
+
+/*
+ *👇 Render functions are a framework specific feature to allow you control on how the component renders.
+ * See https://storybook.js.org/docs/7.0/vue/api/csf
+ * to learn how to use render functions.
+ */
+export const Empty = {
+  render: () => ({
+    components: { List },
+    template: '<List/>',
+  }),
+};
+
+export const OneItem = {
+  render: () => ({
+    components: { List, ListItem },
+    template: '<List><ListItem /></List>',
+  }),
+};
+```
diff --git a/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx b/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
new file mode 100644
index 000000000000..b4d2023904bc
--- /dev/null
+++ b/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
@@ -0,0 +1,41 @@
+```ts
+// List.stories.ts
+
+// Replace vue3 with vue if you are using Storybook for Vue 2
+import type { Meta, StoryObj } from '@storybook/vue3';
+
+import List from './List.vue';
+import ListItem from './ListItem.vue';
+
+const meta = {
+  /* 👇 The title prop is optional.
+   * See https://storybook.js.org/docs/7.0/vue/configure/overview#configure-story-loading
+   * to learn how to generate automatic titles
+   */
+  title: 'List',
+  component: List,
+  subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
+} satisfies Meta<typeof List>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+/*
+ *👇 Render functions are a framework specific feature to allow you control on how the component renders.
+ * See https://storybook.js.org/docs/7.0/vue/api/csf
+ * to learn how to use render functions.
+ */
+export const Empty = {
+  render: () => ({
+    components: { List },
+    template: '<List />',
+  }),
+};
+
+export const OneItem: Story = {
+  render: (args) => ({
+    components: { List, ListItem },
+    template: '<List><ListItem /></List>',
+  }),
+};
+```
diff --git a/docs/snippets/vue/list-story-with-sub-components.ts.mdx b/docs/snippets/vue/list-story-with-sub-components.ts.mdx
new file mode 100644
index 000000000000..e6e6a2a58942
--- /dev/null
+++ b/docs/snippets/vue/list-story-with-sub-components.ts.mdx
@@ -0,0 +1,41 @@
+```ts
+// List.stories.ts
+
+// Replace vue3 with vue if you are using Storybook for Vue 2
+import type { Meta, StoryObj } from '@storybook/vue3';
+
+import List from './List.vue';
+import ListItem from './ListItem.vue';
+
+const meta: Meta<typeof List> = {
+  /* 👇 The title prop is optional.
+   * See https://storybook.js.org/docs/7.0/vue/configure/overview#configure-story-loading
+   * to learn how to generate automatic titles
+   */
+  title: 'List',
+  component: List,
+  subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
+};
+
+export default meta;
+type Story = StoryObj<typeof List>;
+
+/*
+ *👇 Render functions are a framework specific feature to allow you control on how the component renders.
+ * See https://storybook.js.org/docs/7.0/vue/api/csf
+ * to learn how to use render functions.
+ */
+export const Empty: Story = {
+  render: () => ({
+    components: { List },
+    template: '<List/>',
+  }),
+};
+
+export const OneItem: Story = {
+  render: () => ({
+    components: { List, ListItem },
+    template: '<List><ListItem /></List>',
+  }),
+};
+```
diff --git a/docs/snippets/web-components/list-story-with-subcomponents.js.mdx b/docs/snippets/web-components/list-story-with-subcomponents.js.mdx
new file mode 100644
index 000000000000..ced80cc450bf
--- /dev/null
+++ b/docs/snippets/web-components/list-story-with-subcomponents.js.mdx
@@ -0,0 +1,21 @@
+```js
+// List.stories.js
+
+import { html } from 'lit';
+
+export default {
+  title: 'List',
+  component: 'demo-list',
+  subcomponents: { ListItem: 'demo-list-item' }, // 👈 Adds the ListItem component as a subcomponent
+};
+
+export const Empty = {};
+
+export const OneItem = {
+  render: () => html`
+    <demo-list>
+      <demo-list-item></demo-list-item>
+    </demo-list>
+  `,
+};
+```
diff --git a/docs/snippets/web-components/list-story-with-subcomponents.ts.mdx b/docs/snippets/web-components/list-story-with-subcomponents.ts.mdx
new file mode 100644
index 000000000000..511213a1030e
--- /dev/null
+++ b/docs/snippets/web-components/list-story-with-subcomponents.ts.mdx
@@ -0,0 +1,26 @@
+```ts
+// List.stories.ts
+
+import type { Meta, StoryObj } from '@storybook/web-components';
+
+import { html } from 'lit';
+
+const meta: Meta = {
+  title: 'List',
+  component: 'demo-list',
+  subcomponents: { ListItem: 'demo-list-item' }, // 👈 Adds the ListItem component as a subcomponent
+};
+export default meta;
+
+type Story = StoryObj;
+
+export const Empty: Story = {};
+
+export const OneItem: Story = {
+  render: () => html`
+    <demo-list>
+      <demo-list-item></demo-list-item>
+    </demo-list>
+  `,
+};
+```
diff --git a/docs/writing-docs/autodocs.md b/docs/writing-docs/autodocs.md
index 4c1dcaea5fdb..20b459e03f09 100644
--- a/docs/writing-docs/autodocs.md
+++ b/docs/writing-docs/autodocs.md
@@ -183,6 +183,29 @@ Creating automated documentation with Storybook's Autodocs provides you with the
 
 ## Advanced configuration
 
+### Documenting multiple components
+
+Sometimes it's helpful to document multiple components together. For example, a component library’s ButtonGroup and Button components might not make sense without one another.
+
+Autodocs allows you to document your "main" component, defined by the `component` property, as well as one or more `subcomponents` related to it.
+
+<!-- prettier-ignore-start -->
+
+<CodeSnippets
+  paths={[
+    'common/subcomponents-in-meta.js.mdx',
+    'common/subcomponents-in-meta.ts.mdx'
+  ]}
+/>
+
+<!-- prettier-ignore-end -->
+
+![Subcomponents in ArgTypes doc block](./doc-block-arg-types-subcomponents.png)
+
+The main component and its subcomponents will show up in a tabbed version of the [`ArgTypes` doc block](./doc-blocks.md#argtypes). The tab titles will correspond to the keys of the subcomponents object.
+
+If you want to organize your documentation differently for component groups, we recommend [using MDX](./mdx.md). It gives you complete control over how your components are displayed and supports any configuration.
+
 ### Customize the Docs Container
 
 The Docs Container is the component that wraps up the documentation page. It's responsible for rendering the documentation page in Storybook's UI. You can customize it by creating your own component and updating your Storybook UI configuration file (i.e., `.storybook/preview.js`) to reference it.
diff --git a/docs/writing-docs/doc-block-arg-types-subcomponents.png b/docs/writing-docs/doc-block-arg-types-subcomponents.png
new file mode 100644
index 0000000000000000000000000000000000000000..bd883288f6f154c547b35ce94b3a972a4494ba5c
GIT binary patch
literal 10007
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

literal 0
HcmV?d00001

diff --git a/docs/writing-stories/doc-block-arg-types-subcomponents-for-list.png b/docs/writing-stories/doc-block-arg-types-subcomponents-for-list.png
new file mode 100644
index 0000000000000000000000000000000000000000..b0d5469f0e3f441ce6413bab9ef1b5fa80719647
GIT binary patch
literal 16815
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

literal 0
HcmV?d00001

diff --git a/docs/writing-stories/stories-for-multiple-components.md b/docs/writing-stories/stories-for-multiple-components.md
index 4e6ac15a18ef..f03ec9a3c8e0 100644
--- a/docs/writing-stories/stories-for-multiple-components.md
+++ b/docs/writing-stories/stories-for-multiple-components.md
@@ -2,11 +2,40 @@
 title: 'Stories for multiple components'
 ---
 
-It's useful to write stories that [render two or more components](../writing-stories/index.md#stories-for-two-or-more-components) at once if those components are designed to work together. For example, `ButtonGroups`, `Lists`, and `Page` components.
+It's useful to write stories that [render two or more components](../writing-stories/index.md#stories-for-two-or-more-components) at once if those components are designed to work together. For example, `ButtonGroups`, `Lists`, and `Page` components. Here's an example with `List` and `ListItem` components:
+
+<!-- prettier-ignore-start -->
+
+<CodeSnippets
+  paths={[
+    'react/list-story-with-subcomponents.js.mdx',
+    'react/list-story-with-subcomponents.ts.mdx',
+    'angular/list-story-with-subcomponents.ts.mdx',
+    'vue/list-story-with-sub-components.js.mdx',
+    'vue/list-story-with-sub-components.ts.mdx',
+    'web-components/list-story-with-subcomponents.js.mdx',
+    'web-components/list-story-with-subcomponents.ts.mdx',
+  ]}
+  usesCsf3
+  csf2Path="writing-stories/stories-for-multiple-components#snippet-list-story-with-subcomponents"
+/>
+
+<!-- prettier-ignore-end -->
+
+Note that by adding a `subcomponents` property to the default export, we get an extra panel on the [ArgTypes](../writing-docs/doc-blocks.md#argtypes) and [Controls](../essentials/controls.md#) tables, listing the props of `ListItem`:
+
+![Subcomponents in ArgTypes doc block](./doc-block-arg-types-subcomponents-for-list.png)
+
+The downside of the approach used above, where each story creates its own combination of components, is that it does not take advantage of Storybook [Args](../writing-stories/args.md) meaning:
+
+1. You cannot change the stories via the controls panel
+2. There is no [args reuse](../writing-stories/index.md#using-args) possible, which makes the stories harder to maintain.
+
+Let's talk about some techniques you can use to mitigate the above, which are especially useful in more complicated situations.
 
 ## Reusing subcomponent stories
 
-The simplest approach we can take is to reuse the stories of the `ListItem` in the `List`:
+The simplest change we can make to the above is to reuse the stories of the `ListItem` in the `List`:
 
 <!-- prettier-ignore-start -->
 

From f18392262c76070787dcb7e62158b96d6f2a3b38 Mon Sep 17 00:00:00 2001
From: Kyle Gach <kyle.gach@gmail.com>
Date: Mon, 29 Jan 2024 17:09:41 -0700
Subject: [PATCH 3/7] Update docs/writing-docs/autodocs.md

Co-authored-by: Jeppe Reinhold <jeppe@chromatic.com>
---
 docs/writing-docs/autodocs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/writing-docs/autodocs.md b/docs/writing-docs/autodocs.md
index 20b459e03f09..9ea752168c12 100644
--- a/docs/writing-docs/autodocs.md
+++ b/docs/writing-docs/autodocs.md
@@ -202,7 +202,7 @@ Autodocs allows you to document your "main" component, defined by the `component
 
 ![Subcomponents in ArgTypes doc block](./doc-block-arg-types-subcomponents.png)
 
-The main component and its subcomponents will show up in a tabbed version of the [`ArgTypes` doc block](./doc-blocks.md#argtypes). The tab titles will correspond to the keys of the subcomponents object.
+The main component and its subcomponents will show up in a tabbed version of the [`ArgTypes` doc block](./doc-blocks.md#argtypes). The tab titles will correspond to the keys of the `subcomponents` object.
 
 If you want to organize your documentation differently for component groups, we recommend [using MDX](./mdx.md). It gives you complete control over how your components are displayed and supports any configuration.
 

From fd87a7f3e4d26df27f9ec557f541e1d975287dcd Mon Sep 17 00:00:00 2001
From: Kyle Gach <kyle.gach@gmail.com>
Date: Mon, 29 Jan 2024 17:10:44 -0700
Subject: [PATCH 4/7] Address comments

- Update un-reverted snippets for v8
---
 .../list-story-with-subcomponents.ts.mdx       | 13 +------------
 .../react/list-story-with-subcomponents.js.mdx |  8 +-------
 .../list-story-with-subcomponents.ts-4-9.mdx   | 14 ++++----------
 .../react/list-story-with-subcomponents.ts.mdx |  9 ++-------
 .../vue/list-story-with-sub-components.js.mdx  | 11 -----------
 .../list-story-with-sub-components.ts-4-9.mdx  | 18 +++---------------
 .../vue/list-story-with-sub-components.ts.mdx  | 16 ++--------------
 .../list-story-with-subcomponents.js.mdx       |  1 -
 .../list-story-with-subcomponents.ts.mdx       |  1 -
 9 files changed, 13 insertions(+), 78 deletions(-)

diff --git a/docs/snippets/angular/list-story-with-subcomponents.ts.mdx b/docs/snippets/angular/list-story-with-subcomponents.ts.mdx
index 17e8ab2e60aa..e79ac6301ded 100644
--- a/docs/snippets/angular/list-story-with-subcomponents.ts.mdx
+++ b/docs/snippets/angular/list-story-with-subcomponents.ts.mdx
@@ -1,6 +1,5 @@
 ```ts
 // List.stories.ts
-
 import type { Meta, StoryObj } from '@storybook/angular';
 
 import { moduleMetadata } from '@storybook/angular';
@@ -11,11 +10,6 @@ import { List } from './list.component';
 import { ListItem } from './list-item.component';
 
 const meta: Meta<List> = {
-  /* 👇 The title prop is optional.
-   * See https://storybook.js.org/docs/7.0/angular/configure/overview#configure-story-loading
-   * to learn how to generate automatic titles
-   */
-  title: 'List',
   component: List,
   subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
   decorators: [
@@ -25,15 +19,10 @@ const meta: Meta<List> = {
     }),
   ],
 };
-
 export default meta;
+
 type Story = StoryObj<List>;
 
-/*
- *👇 Render functions are a framework specific feature to allow you control on how the component renders.
- * See https://storybook.js.org/docs/7.0/angular/api/csf
- * to learn how to use render functions.
- */
 export const Empty: Story = {};
 
 export const OneItem: Story = {
diff --git a/docs/snippets/react/list-story-with-subcomponents.js.mdx b/docs/snippets/react/list-story-with-subcomponents.js.mdx
index 1bae39ac9a4e..4edaa677c3f5 100644
--- a/docs/snippets/react/list-story-with-subcomponents.js.mdx
+++ b/docs/snippets/react/list-story-with-subcomponents.js.mdx
@@ -1,17 +1,11 @@
-```js
+```jsx
 // List.stories.js|jsx
-
 import React from 'react';
 
 import { List } from './List';
 import { ListItem } from './ListItem';
 
 export default {
-  /* 👇 The title prop is optional.
-   * See https://storybook.js.org/docs/7.0/react/configure/overview#configure-story-loading
-   * to learn how to generate automatic titles
-   */
-  title: 'List',
   component: List,
   subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
 };
diff --git a/docs/snippets/react/list-story-with-subcomponents.ts-4-9.mdx b/docs/snippets/react/list-story-with-subcomponents.ts-4-9.mdx
index 71abc96d3c2c..d527fe149fac 100644
--- a/docs/snippets/react/list-story-with-subcomponents.ts-4-9.mdx
+++ b/docs/snippets/react/list-story-with-subcomponents.ts-4-9.mdx
@@ -1,23 +1,17 @@
-```ts
+```tsx
 // List.stories.ts|tsx
-
+import React from 'react';
 import type { Meta, StoryObj } from '@storybook/react';
 
 import { List } from './List';
 import { ListItem } from './ListItem';
 
 const meta = {
-  /* 👇 The title prop is optional.
-   * See https://storybook.js.org/docs/7.0/react/configure/overview#configure-story-loading
-   * to learn how to generate automatic titles
-   */
-  title: 'List',
   component: List,
-  //👈 Adds the ListItem component as a subcomponent
-  subcomponents: { ListItem },
+  subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
 } satisfies Meta<typeof List>;
-
 export default meta;
+
 type Story = StoryObj<typeof meta>;
 
 export const Empty: Story = {};
diff --git a/docs/snippets/react/list-story-with-subcomponents.ts.mdx b/docs/snippets/react/list-story-with-subcomponents.ts.mdx
index dcb959020f98..71a08b1fe6bb 100644
--- a/docs/snippets/react/list-story-with-subcomponents.ts.mdx
+++ b/docs/snippets/react/list-story-with-subcomponents.ts.mdx
@@ -1,22 +1,17 @@
 ```tsx
 // List.stories.ts|tsx
-
+import React from 'react';
 import type { Meta, StoryObj } from '@storybook/react';
 
 import { List } from './List';
 import { ListItem } from './ListItem';
 
 const meta: Meta<typeof List> = {
-  /* 👇 The title prop is optional.
-   * See https://storybook.js.org/docs/7.0/react/configure/overview#configure-story-loading
-   * to learn how to generate automatic titles
-   */
-  title: 'List',
   component: List,
   subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
 };
-
 export default meta;
+
 type Story = StoryObj<typeof List>;
 
 export const Empty: Story = {};
diff --git a/docs/snippets/vue/list-story-with-sub-components.js.mdx b/docs/snippets/vue/list-story-with-sub-components.js.mdx
index 9d674dbfebf4..0c6e082e6a92 100644
--- a/docs/snippets/vue/list-story-with-sub-components.js.mdx
+++ b/docs/snippets/vue/list-story-with-sub-components.js.mdx
@@ -1,24 +1,13 @@
 ```js
 // List.stories.js
-
 import List from './List.vue';
 import ListItem from './ListItem.vue';
 
 export default {
-  /* 👇 The title prop is optional.
-   * See https://storybook.js.org/docs/7.0/vue/configure/overview#configure-story-loading
-   * to learn how to generate automatic titles
-   */
-  title: 'List',
   component: List,
   subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
 };
 
-/*
- *👇 Render functions are a framework specific feature to allow you control on how the component renders.
- * See https://storybook.js.org/docs/7.0/vue/api/csf
- * to learn how to use render functions.
- */
 export const Empty = {
   render: () => ({
     components: { List },
diff --git a/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx b/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
index b4d2023904bc..7d9c073bfa83 100644
--- a/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
+++ b/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
@@ -1,31 +1,19 @@
 ```ts
 // List.stories.ts
-
-// Replace vue3 with vue if you are using Storybook for Vue 2
 import type { Meta, StoryObj } from '@storybook/vue3';
 
 import List from './List.vue';
 import ListItem from './ListItem.vue';
 
 const meta = {
-  /* 👇 The title prop is optional.
-   * See https://storybook.js.org/docs/7.0/vue/configure/overview#configure-story-loading
-   * to learn how to generate automatic titles
-   */
-  title: 'List',
   component: List,
   subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
 } satisfies Meta<typeof List>;
-
 export default meta;
+
 type Story = StoryObj<typeof meta>;
 
-/*
- *👇 Render functions are a framework specific feature to allow you control on how the component renders.
- * See https://storybook.js.org/docs/7.0/vue/api/csf
- * to learn how to use render functions.
- */
-export const Empty = {
+export const Empty: Story = {
   render: () => ({
     components: { List },
     template: '<List />',
@@ -33,7 +21,7 @@ export const Empty = {
 };
 
 export const OneItem: Story = {
-  render: (args) => ({
+  render: () => ({
     components: { List, ListItem },
     template: '<List><ListItem /></List>',
   }),
diff --git a/docs/snippets/vue/list-story-with-sub-components.ts.mdx b/docs/snippets/vue/list-story-with-sub-components.ts.mdx
index e6e6a2a58942..b299d5350314 100644
--- a/docs/snippets/vue/list-story-with-sub-components.ts.mdx
+++ b/docs/snippets/vue/list-story-with-sub-components.ts.mdx
@@ -1,34 +1,22 @@
 ```ts
 // List.stories.ts
-
-// Replace vue3 with vue if you are using Storybook for Vue 2
 import type { Meta, StoryObj } from '@storybook/vue3';
 
 import List from './List.vue';
 import ListItem from './ListItem.vue';
 
 const meta: Meta<typeof List> = {
-  /* 👇 The title prop is optional.
-   * See https://storybook.js.org/docs/7.0/vue/configure/overview#configure-story-loading
-   * to learn how to generate automatic titles
-   */
-  title: 'List',
   component: List,
   subcomponents: { ListItem }, //👈 Adds the ListItem component as a subcomponent
 };
-
 export default meta;
+
 type Story = StoryObj<typeof List>;
 
-/*
- *👇 Render functions are a framework specific feature to allow you control on how the component renders.
- * See https://storybook.js.org/docs/7.0/vue/api/csf
- * to learn how to use render functions.
- */
 export const Empty: Story = {
   render: () => ({
     components: { List },
-    template: '<List/>',
+    template: '<List />',
   }),
 };
 
diff --git a/docs/snippets/web-components/list-story-with-subcomponents.js.mdx b/docs/snippets/web-components/list-story-with-subcomponents.js.mdx
index ced80cc450bf..2e34a5e7104d 100644
--- a/docs/snippets/web-components/list-story-with-subcomponents.js.mdx
+++ b/docs/snippets/web-components/list-story-with-subcomponents.js.mdx
@@ -1,6 +1,5 @@
 ```js
 // List.stories.js
-
 import { html } from 'lit';
 
 export default {
diff --git a/docs/snippets/web-components/list-story-with-subcomponents.ts.mdx b/docs/snippets/web-components/list-story-with-subcomponents.ts.mdx
index 511213a1030e..d433d2f02fd0 100644
--- a/docs/snippets/web-components/list-story-with-subcomponents.ts.mdx
+++ b/docs/snippets/web-components/list-story-with-subcomponents.ts.mdx
@@ -1,6 +1,5 @@
 ```ts
 // List.stories.ts
-
 import type { Meta, StoryObj } from '@storybook/web-components';
 
 import { html } from 'lit';

From b644216cc4c8be2e0d95271b60bd7f9675f86a57 Mon Sep 17 00:00:00 2001
From: Kyle Gach <kyle.gach@gmail.com>
Date: Tue, 30 Jan 2024 10:07:24 -0700
Subject: [PATCH 5/7] Consolidate snippets

---
 .../common/subcomponents-in-meta.js.mdx         |  10 ----------
 .../common/subcomponents-in-meta.ts-4-9.mdx     |  15 ---------------
 .../common/subcomponents-in-meta.ts.mdx         |  15 ---------------
 docs/writing-docs/autodocs.md                   |  13 ++++++++++---
 .../doc-block-arg-types-subcomponents.png       | Bin 10007 -> 0 bytes
 5 files changed, 10 insertions(+), 43 deletions(-)
 delete mode 100644 docs/snippets/common/subcomponents-in-meta.js.mdx
 delete mode 100644 docs/snippets/common/subcomponents-in-meta.ts-4-9.mdx
 delete mode 100644 docs/snippets/common/subcomponents-in-meta.ts.mdx
 delete mode 100644 docs/writing-docs/doc-block-arg-types-subcomponents.png

diff --git a/docs/snippets/common/subcomponents-in-meta.js.mdx b/docs/snippets/common/subcomponents-in-meta.js.mdx
deleted file mode 100644
index c925367d0b09..000000000000
--- a/docs/snippets/common/subcomponents-in-meta.js.mdx
+++ /dev/null
@@ -1,10 +0,0 @@
-```js
-// ButtonGroup.stories.js|jsx
-
-import { Button, ButtonGroup } from './ButtonGroup';
-
-export default {
-  component: ButtonGroup,
-  subcomponents: { Button },
-};
-```
diff --git a/docs/snippets/common/subcomponents-in-meta.ts-4-9.mdx b/docs/snippets/common/subcomponents-in-meta.ts-4-9.mdx
deleted file mode 100644
index 49f5deefb5ca..000000000000
--- a/docs/snippets/common/subcomponents-in-meta.ts-4-9.mdx
+++ /dev/null
@@ -1,15 +0,0 @@
-```ts
-// ButtonGroup.stories.ts|tsx
-
-// Replace your-framework with the name of your framework
-import type { Meta, StoryObj } from '@storybook/your-framework';
-
-import { Button, ButtonGroup } from './ButtonGroup';
-
-const meta = {
-  component: ButtonGroup,
-  subcomponents: { Button },
-} satisfies Meta<typeof Button>;
-
-export default meta;
-```
\ No newline at end of file
diff --git a/docs/snippets/common/subcomponents-in-meta.ts.mdx b/docs/snippets/common/subcomponents-in-meta.ts.mdx
deleted file mode 100644
index 8847609e9fac..000000000000
--- a/docs/snippets/common/subcomponents-in-meta.ts.mdx
+++ /dev/null
@@ -1,15 +0,0 @@
-```ts
-// ButtonGroup.stories.ts|tsx
-
-// Replace your-framework with the name of your framework
-import type { Meta } from '@storybook/your-framework';
-
-import { Button, ButtonGroup } from './ButtonGroup';
-
-const meta: Meta<typeof ButtonGroup> = {
-  component: ButtonGroup,
-  subcomponents: { Button },
-};
-
-export default meta;
-```
\ No newline at end of file
diff --git a/docs/writing-docs/autodocs.md b/docs/writing-docs/autodocs.md
index 9ea752168c12..a89dd0a51d2f 100644
--- a/docs/writing-docs/autodocs.md
+++ b/docs/writing-docs/autodocs.md
@@ -193,14 +193,21 @@ Autodocs allows you to document your "main" component, defined by the `component
 
 <CodeSnippets
   paths={[
-    'common/subcomponents-in-meta.js.mdx',
-    'common/subcomponents-in-meta.ts.mdx'
+    'react/list-story-with-subcomponents.js.mdx',
+    'react/list-story-with-subcomponents.ts.mdx',
+    'angular/list-story-with-subcomponents.ts.mdx',
+    'vue/list-story-with-sub-components.js.mdx',
+    'vue/list-story-with-sub-components.ts.mdx',
+    'web-components/list-story-with-subcomponents.js.mdx',
+    'web-components/list-story-with-subcomponents.ts.mdx',
   ]}
+  usesCsf3
+  csf2Path="writing-stories/stories-for-multiple-components#snippet-list-story-with-subcomponents"
 />
 
 <!-- prettier-ignore-end -->
 
-![Subcomponents in ArgTypes doc block](./doc-block-arg-types-subcomponents.png)
+![Subcomponents in ArgTypes doc block](../writing-stories/doc-block-arg-types-subcomponents-for-list.png)
 
 The main component and its subcomponents will show up in a tabbed version of the [`ArgTypes` doc block](./doc-blocks.md#argtypes). The tab titles will correspond to the keys of the `subcomponents` object.
 
diff --git a/docs/writing-docs/doc-block-arg-types-subcomponents.png b/docs/writing-docs/doc-block-arg-types-subcomponents.png
deleted file mode 100644
index bd883288f6f154c547b35ce94b3a972a4494ba5c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10007
zcmb_=1yEc~l<oitG7J*jAvnPU0|Nw22p)n%7~F#mA$X7k1_{C4CAb9(t}{5nL$E;x
z2=4AY{;l1r-S^(sd$qf#ZdLa=_tbY!pYFcr>kfPSMu7lG0|Wp71WJmpGy#A|XaE4C
z3m5CbqL@2;{h)x~s%p#M-{0Tf-mR~%-`w0>U0pF0-ln9aY;0_N`}Xbh^z`E5LP$tx
ze}8{#Yin_7abaQM=;&y5brp?9r>3T+r>9R(PZtyvpiro~y1LBF%!-PN#Kgpbfq|W!
zosp4|=H}+c#>TR;vWba_yu7^9($a{Ch_0@#-rimW0@2pi78e(nlamt_73JvYSXo(F
zU0p3ID*EToA7y3bqN1W#uU^g0&bGI=XJ==-ySpD>-S@8D%gD&E7T-dl(AwJCpr9Zh
zAD`IRSPc!0!^1;sYinIy-IJ4(U%!48Oy5mTPD)5fylcEOH#Z;Ky7%b5JHNT_Sh;iV
zyxTp$w`sfMDZQQ9yO*oJO`EuHLf?n|x&xQrY1ZE^AKm-=`+w=biyOUPJh-o!zgPWv
zyMA&%xN%=Tcdu1{Cm@eY3;?iYD7})^_MF}6{QQtqKtT3wF=a94Ki&UStk-vZ#<3BA
zyZHM2yoRT{`go2{D7umrLsK4AA4K)9nG?%Cmd#~yUA$-6$@D=(RYVhOT@Clndp);|
z_V)xE7x&<5Id3`1fN;70thpl)$9nMiDm`-hc*XAnZB+1UBE6cA-tKpKo#C2x&$kju
z*A*=lT6>aMZ|LLG(n-&U{1cMp4!NZYrl5-m_O&j58=mxN*yHx@ziz2Q+XxlSzA`%w
z84?=>YjTmC)6^jkp4w2suf(GJLL~e>U7*+@Dg1LK+W@&kL^hh$#0<+w6E=*HAUQ*O
zBwwZa3&Q-A31vv^6(nd0LfCj-Flk_!V-s-LbtUP?khNHuMf}m=G^P<o!Nln`C+6iH
z8~kXfP0}YuqPRW9V1B7}DP|4Cw9^{>$I9BcKihj?;F0aBowyj*0#M-vhfK}<QW<UT
z7e&~_uDgOv@<g_fKl9_L<4auKV?n&6<3{Yh<ukLU7PG_9-x<hkiQ7YAb=pF_hD-Vv
zrovC36wl!7Zm&92Ry}#b0}y^k{(7*+iG${l6;O*Z4u0E**<DGKFw)FL3@Lw|e<KTF
zO5xv+^GG+ZDyj)0sqi@J#sFU0G1PuSx~hwQeDn_Q`e`Ruv7*VCQZ&|3zZGtzMF(x6
zLas+-90BNcA%DJ<XN2xE66CJM+u_m9r|+tEy#D?Ssy5jo9~m;+P!WDnrMG;(9KA$p
zNuNYUCmu-{Ji(r`eZVrJH;FZ(X4~0C_7xHnOghL*u=Mp46ce5K$Oe|U2KpOJ0j?Fd
zIb6ZSO=4|oS7oW8)pt!}=P~$p+6$n+*|5-J@n@Ny)NT=3)sgV9TjgR#K0O7YAAQ$m
zd&#9QGp4dLV>#j#N5Q@jBW<WH3)c0Em*<G?5CPVHZ7%-)g2E1Pz4{$9h@X{HmKiDd
zckj^ERDhz*vda6i50vyQG(W-qNT}cFSuHk~Or+ZZ2TdlGhzd@4d-n6Se$IY^^1z5z
zt3xxs<Yc)g{Npf_;?H$pI`OZr{RAGv{=&2YreC9I!u3coC;ps*wj(}8I0&Oa^r0_a
z*+7QY(zxbt4owN&;0IyN$Q6X4Q$vPZW3do2#XUIY*rRLF8R;I359&b(Qh0V-Y6lOR
zhl?Bi!UJOK#Ajz5vC*VX*9Fh{o*ABU6zo}&yD$?J&Z|}^joyZ#`Ig=Vakt&lNsn_+
zW6(q%jnywS0ZWSGD8Bs@03Ah@u0jkoA+&^2>c<dG;%Khq6{_Ia7>5btb9iC*kgZ76
z^I!S~PPih)xAb;l;%%2tZ5#B)VQf#DK6mPm7<zmcOh^AwT*8}3@exL{Xa;2MZ>!xD
z|5Xv@sR}^nfz!re*dniO8OKjFKR?WA1FoOpDhXyVexqIXLi4IhBaTx8TBf;s-G}&B
z7rWc28Lp#b8Mf=tqT(p51))Wwk}HIA3XV1}5d(Ny)WjWs3JwR@98g{aM76R)L_|?G
z>E8`Z_o;uu>M)u&!p?fQd*$%|1^s}iCwD=W&G7Lj2}JX6QYKc_iBDOUDq^(R-B&>+
zj&s*{uU?YiQ}L}9eD)q$-bTd9m;>Qa7a)%|)GX{}QxVIH=%q+nr(ygGnP~Qpf}W~E
zPRVt{Ow)>?Xm*)~4&WH|aP~EaR4bmmJF<bl0=LxiPIT!}I2h39irfurT`&~4sd4b>
z4|+Ro+fct(_s`Uk6za1<jpc11*Q}3Yd1#yD^YbyfvuqX3=V%CN?Z0Z<FR82Mgi;El
z99~#UjFvhQh*E4db^c@&LQ&zWyfX+WUvLtD;(Un+qH<y##{Iz}L??kaIPT?D$u~H*
zE?&lkcNq{7Y{3}P8-%HA89V_OxHVC!N+CL{6NZ`!Bno7P{|W7YJ)RRuS-G&1`-wh1
zOGdxB^jhh+m-!SH%vzU^uB^(vD5vbmdRV<2M+IiG=ik%~X$ZIZ1gHefjGjvl3{>B-
z+BQT1XlZ5~ATqjCb}`fy-D|Ug8A;|8?>=^G!ofdJ#l{4Mplf3L7gr(CUF)U_V%|r_
z3j?suPJMIu@l$3bI(O$c_>%Z2nI7@MHZ-K}@!cyV$=o<>+lMOSww0MwD_E=Rn{fIx
zx8EEBcEtO%P&OIO*A*v11v<!x6oyvDWTS(oD5&J?gC&^F)Es(<)6eCvcJ7McN8WXH
z7c{S72l&W--xOge_&4lxXO}so5r?9_=W$HnPZ8tEEL&Uiaab!1*<ZgfT9JSzJ0x*x
zV4DLPhq+Bbx?tvN?%ZclLbyUG)*<6)Lk+tIQx==$`As1tZ_ttT7}XoPt#iPOCb=hH
zpLdYb%BxMCl4%!3b#+^W&zEO@F~vtVmi4qH4<x)rKE@^uN3T9%<!hSNp^rVnJ=7Yk
zsX7?Vvh_6I?_Qdd7DVM-JVz6Hlg9r`3=r+PZ{^JlGsACboY)EKZ_Hdox|n{$SR8y?
z5HNuPojmlH2%Z^DLesNfFv{G;<06n=7w5`>S1Kk5_Xa4~f9{ZZbJyPMOrvbBQMkXe
zvtdX@IAtZ`%y2E3MLVodyNAmpklX-L5KVUODj{<>AawrFNOxw`qu`&L6BhPU;Jp^j
z@X79B)wm!w8|WdVDpFz8uK8FNDj)Cs(>!>`oe_?{qEcO>Kins2i+pPtv{`f<kTocP
zJnX69FmcYbb`awrSa%Nc_*lPVk_SgeU;EvEC1k@yo^C~~p|AX>FM^~?sCRtu)%+Ix
z95(o*D4!Z;lW*@ZS9eG4f4!Mwoy?-CNFDr3`*B52Ho{bT@@DKR+*Mfd6SD?AZ843~
zqN%w6lr2dmUQkAqeg#n7pV<Gw_GoxZe@p$LkYEpe*MC74JZSM&w7SFFwq5G)_43z>
ziGhmeD37z@B2h;w+>Z5RDOMn^B4@<!_$po6qVcnUCScIjI8HJ<MTD#Y7fBiK{XM^f
z`#vl_{%c9J@<toZ5-1rp$Z_pJ$}Z6d3*N(&e0eg&FmKW%T$r+n!RUgsO~6rrgL@@p
z-Js1ehKpqZL2`OGqd}hov1kxAE<3@Go>MIIkQ3@G`CMtVSV97mrfQ%;Aj+jk6E;#c
zeiuOr0lJ)wN#Q3I&L#QUCX(RTunP6ER~Xd8B4W!=YTpuFgld^01*s<@4D-HoL{Tj%
z2fk-Q^6CcDE-*5Q*3_aw$VEXrc|0VW_~&-2p$K$S{q&#DyfhW;7zemsH#|iz47+o@
zX(bOXK?Ic8Cv90F5ukOWC6M+66EdR=l!QMD3k#o#K`WX?M)kfG4B@Vs;7wBg=xc5w
zFlt{s9U!)*7u+mW$p82$ZDc={MZ;#4(j%at9{Sc)4yQ8rj)1(YM|yId@pmCR%Wmf!
zZg-+ET@_u5bcZSx-$K}06tHm6<rhpqPuj0Oz>%7-NK{2e8*^Tl-~8M9*bf0dVZ-v*
z7=17%`zFdCx<Le>bw&}o(N8DZo=|3_Y`#2sskzqes?wG@-*4`Bw+@|iML)Vedar&#
z=&0SroMe6=mZZ}?W6dKm%1XW|KpY=&@Y=EMtf<T`+54VW&T`UBr+i`;4DQdgMcHwr
zJz`?U%#)-7nPJUF-Tqx69?z3_QZtN2%!)+ocMSI#JQih;&;`fKaF-BrV)9g39L^^k
zybCgHeIt@$oEK`M`nqov4skEmtmc}AXxQmwSjMRq+9nN(2!LKvAzO)RaTYQAHi6Xl
z_}EB+YfH$%Y2KOtWJXk|5D4qq8Zsz!>VW}53e2%;ii!n!blo1THVp3bK!VNAh&Cxo
zyxKAVNP&m<|MuKi5D`B5hfxRIn9$1V{0D(&h;w2B9?1ZDLTdaiTsaLxF#v#11uU4L
ztx!OqICDpKB(6Xa3*o^FBsJk3`Txnw0|puBaR0@8*)H;><i9SJI5_`8{blZcL}dR*
z7@&{)RH_J7kJ$}l!ilCsAy}>4rH!><mg@Pdx(ouj9E-(!{9VB?Lk0bq*58|%i?Z<M
z9GrzHJ@C6fE|7BF(qc+-J^erZRKp66yJ~C4I0l8*5dLor?0S;7kpu#NR2V)tmRX2@
zS{Y9JTeuN!{0Hn`^yBz%Cqlyt*jA>sa;Wygeh!h*juctYw?J)MC3Tb!C*hPipx>nS
z3dvqj0_zWb7pvgcHgvUz#)Pb67o!MAU+LeMhXPKH=r<`iW8K~I($I22r<2kqGb&?c
zH;ay#vFCcwe(_AC=pEsay;2ATAKWK{k%(n;7Lg%9wDt@VNB1T2uCfI7r+qm)V*Nm=
z4#ps{UBHXld^YT3h4t%1h0d@+%cZX;D}dGz;#C=8c4mQ|UD@FyxUtfD%|BSZxAHRH
zX<uS|*CF~kN4Z=nK5wj+W1Dkp-AJlSZCBVj&{N<lS92f9-1ptU<ng-oYR}$H8?Rlm
zmEQ2~$0dq1r+EDK9Ue+Afu`8s{nZj3Adc?t9QWBl&anBh2$o{1cD;+?q1!NCG`_Lp
z%7g>Pg@H)Ii97gtyFMyjey%lLXAj)GK<N}~C5TGVFkJ5rJd`As;)c2=YSO&WiCF|q
zQ;U%T83#Hp$zso|BXj*0+5yg1Em2&S^wfG7`5K0?$6=Zz${0c1Oyz_=hX+!*l`-Bs
zLwVV=z8;lXVw!@+Z@4V0-y8d`FeH3#a(%|4Fb*DFZ12ZEho@CfO?u6c4;#pMU$(-&
zGDTHCqSA${xJZ5zJM0C7HpiyA;xhD5=S5XV=J+jKPlm*ml2HsM;A<&mkYOW>vzEnU
zg&vJ_K1V8Pa4@piNpeGFDle#B&Q58?=E=mePB_DT=ww<L8m-R0y2v%X5vZ`5Y&q-s
z&WdxydRgTD)nE;E!+K+fmSV+=PG!rQQ}NP+{4_ccU&N<$a;EP$z;N6oVTrGB?P%3@
z1%2WROn#x1+QDJa`&N42(UeQFpfdLNVd$bVEi5h8yCy%6Twq&qs6Silci2a-vG`2#
z$YK^S6gPEbAGwR~f#dXYoP;XL;<Y0f$?T;&RO$?kaK3l2MuyLS!ry*}z6-yGSrjwA
z)V(f1^Nw<6VXF5;ABla$^o)LYxz`DUn){speOMB$T6}hRE`~ji66GiAX6@N4-D_9k
z-M(Hw&!pTNj&adS5Aa4;e2#FhTS{2TW<iFOm!;}0dg?SNgVpcn5WZIHC~wlo2!WfY
zuS{@hwhayfmWv+e+NsVptEt9`+}``!npsz}%ncZ$D~4Sy(pAluuMY({vWfDt)`NxU
zCD6!4>$bhR;rleI>G1Xv3mZBo=d(L$7u|h=r&(A_Gt@6lS+#$9dtayi;n@r#Dl4*W
z2qQLq^s7w}MRO_Xh?hN-<`MtIvS%Xxt?aTqGUW|^fNy>9cgYTh4@l~fc4JbQ)L(>9
zzQd6?5k}Mo9`K6FmMwm&na=$*8Yu+U?c0zNu}m6HL9h8!?WI5ji9cC105(Vp+594-
zwuIJXGKAT*qZ`a2HfyI;kiA=);Z2M?LaOK%y2zEz&lw=mUjz#4!T2~Ntu0Wzzo$}|
zO9ypVGS3H|XMBt4WH(3Yu!P0yj=_)<N<s7I!P`$lO!#vRXe)x0Nt1%(n&l2wWIY#y
zzgsi!^4kbf#Kb^_p;#U9!g>nj=QLe%$>-~PQP*U27=M;lDhf%EL!nwY?BlStOCIp0
zc*)XxWP*m<atT^QrqwDGJ89#ovok6My>V>WK*>}<MoCFvBe)d!fK`0nL#0??-u%11
zD0E_I+0Q0G&%9xB^O;=?-6>Z_mRB=${(!)-LGzhvi*19xbq!gt>#@!sgHD)H$M?BF
z+Bd|j!E=~lYL+|vw2^)oz1aEFQQooM@|LZ%&gBZ&rbw&qfR4O)GnrQzF)CcIf2|nH
zETp~9ybMHF{`x?GvDT+?t1FnkiB-i*l+qS00;SgBsG#9{B<JTr8Z1ODP&t0**9pUC
za@kmW3$p1M-~ngy5^)Nq?_xRBFL*2XM&G8M04U@&Fo*l{KCLv1E<XAp6K6}b*7}Pb
zzY2R|4>NTAI6CJ(5KTom*AY@iSW3v0&ZC~e7#YCmKnWmBeE47jhjDT~;`(Oexf$dL
zK&Q|gL=F<gA|A4-cYh`)NY@yHvcv5#V0;*!xRIiqFT<Yq$w7C+OH82v*3Gyox#4i=
zCyL4;qTsaOohhX2DTnb^HaU>a4(5lPmArw1)9D9_^3erh7i~OL!??~z+ClFjG;8Z<
zsUFZgIDtB{%yIU~n5=Y?x0+=u$B%2b#XM4?Qe4y4UJvC>PbrW1Pnvg*evg)XA{fs#
zjrcKdB4oeJKEt3;UZ0i1SaPNx4=znT>e4~RfPVyb-v$fQso{WlcG4arV}2H66^;2W
zHJo@PYu#GM_*3|l{B8%kB{=u^Of=p|(IXvc^F}jg*ZZ4?41I{Y@1s;(6q||XYol8=
zS-eFG8r__3hi+*i)-uO}Cv1h=XR0h{9x6Gu*~pE3CeirUrEC>+03RF+QFl4??+Sm%
zOjRIRh#Aw@FLgY`BEYVhYvIqRdqphwzIXi&c?Da<QHuos&K+=KhP{E3J`x#vhI6w0
z?DxpABgV$G^UJ-sdeCUO`f3{?s(SS&gJ^&gz1xu9N`d=+8-0HKqtSBBfkP)$(r2H<
zqhH4l>Lt%)Lc<SCJ(U4cne`9PPL-iP=%Z5BYXYi{^a1WHxIH1ty=EyuaP{Nda2J?z
zFLUdWKv3%55L|)-3PuNLtZI)unfjEMI8RAP)zy-;t?I}No#hCS-6?K`4OW)}alToo
zZ`biezz64=q}c;xU!1uO0&#-!U@}l3PFMc_Ky%)^Krfmf(Pc*G&kW-8B39vM&JE=(
zvK5XfO6g}(&Ur(<@MZtr5$Y}qn<d>ph)j#WlkyLUPKH=tG&#s|2k9GWLY{VQ#Uk*Y
z>L!uB!L4e_gUN+XvcXB^%J{g_iOt=V&_Tqd_F-_t;}<`|{I`aW$r5=_T6}Pyu5o!U
z;FV$RW6R9gcRWMYx7c?*uNT{&Df>i;jU4{yJ0c->#Zv`KW1YJwWawi^bW~kq3Q8_i
z%tUyvNd;Ieuy=09?rg7}DiQ+HzuEnEkZNj?xl%-T`E&cf`*LAL-X~tB5ul&NW^1LH
zP;&*qIoVpoKwW+E8(4I>-kCc!kpIWoT*T?fQ{8Z0_NJPy8k1#Y^don*%fWPrOP5AZ
znOOGo@L4I*U78R@My_=IUn$R)CG96ALrwIOwgtAV71yp9zJ<C`J+05)75rfK;_XZ`
zR^G_{TgZCh?oG@5CEWEuFQsvC;oeCBc)m#frmW(Lk*TWy)yJ6#XROzOvJ9NjY*dm9
z9Qi)MZathtGKY^gYjzNS>swqr+}#WG@p0}t((?UwRrqPnGw1k$>m?5t`oMr#nhO>k
z1rAUY#tHJE->y_PV7edK5%sze+?*u<8d5*y{WgX1=XB*JgYxkLsc>_-aVZb{I=SrH
z51r1l5aa)|cvUxV5(dhK&=In{S)L2{jutT4m5wI5^}8=yWOSwS*O2SL()T*T?x1LA
z_DzH~WZ*>@O;AULjqdH+zZ&FL#ZSUhTG(84NlIPZn<0f59kmr?3A8J7Kbsp9o_Xb9
zvOl_aZYj4yJiFdku@H~ob=qzFuD#m?;&t^i)-rq;grh#rI{e0<BH_hwmc5T6G}A_U
zcU616>vN3r$KSdZ>l-dO%;gN2`tF!-G}@OrYHw&r)p~8{!}`805T^9Fs;cloyDFxR
zl}zrjfl}0-nd-AHPGY%!%uIm}nvnGrOM;Hqril?73N;7<wF0QNk~^{=(pLV93)*G7
zynXHL-5zLZXkh}ZFG|zhu5f8eE0r14Ed`(Ezbnr~h-=eMm1t?zi<lk8ri;JKEgASZ
zJKU(LX1kXt?!3t5_K{P_Z4>M$o5^5KI?;GKPHMoPpbXdKT5`XEH>*1_3kvYtas-mS
z`+)Y0!FY!CVFz>L{M1xre+E74_X=D6$_BTci3|1EPJJ{euf6n`9HtA2+#leBy{=Ap
ztjtoq-DU(?d(K(=%c92ao<v3>m&{3{G5qv=4NW-dQoaG9^-@hRp{SU24`>qq@<*2d
zpy#sx>Iyuh$g)CY7T@Pag+UuSAAPN;n!Iql{*b2;hYMD_Xe^5)I*AUEel4n$JeW@G
zNTl(^H&ks;I0BsGwc3}`CMoIJ3}Y~_P}d!Ls#K?wfZ!d_G4yPQ{q(hUrrawPYbqzK
zwa^*=0h$a@Y&Q}b(nYVNBW{`S{VAOA?S8HzjF20#y^0N4XSPTCF`e6`@`Osk)LqIo
znN~Lj=oi<I9P490wi-1cDF>&N{^XP^p(zrz)Kfh0Jpw&|>vE-By%nV<EaYsA>DS~Z
zLyu5|w64JVHxw~cFv@?>Gv3fT5A*o9gK(rGz^1Rfe*i_<#XjcHN23A+lgZ!68j8{j
z1zTRYqj&ri)(q8$_G-WVLh_b*<}m#5vs|Ziy5Gl7(qfPGv95Dckd)0caW4A~>l{c&
zSoO1$JW-F)y&oZOuY=iR#m+Cl%;QLJppdN94tK{W%j&|tGFZlp%#NupWPca&(}Zj<
zaUyU<5lx{7DdIZyOuIaX59%2<4_WA_{SB)1+#EZ;siNHeu;CR^4-DDku{S6<5|6ph
zhc(wI8)11^9;^b?3>)yoJa73<LsyFerV9;v&Mvjk&{zfj5RcQ%=Fzlz{CaC((e7aL
z?<kluPSn=XA|>JCimowg{pmO#sOj4ms@sdTt04q|7lwV5AI3lF@fwZAK8;m0nn7^I
znwXFiip9o#A}NdsPrfRKSqr_iB~Ke27xoHqrX)0C?={y0p35#W=%7s~hg)Y$$SeWp
z_6?%++?ujJrLc1l9o5&Tn)dzhl>`RyQ$=ZKY)4YSB2FDlEw=T7!Rhol7u`EnNy?5G
zW6!I`yI<{Od&#T$3y})P^(@<So6SRe=?M7hg%V?h4Dejzyad9HiXx(@7`q}o47aVa
zT|@G(Qw&EmSWwEV9{%2n#b2K&J&ikBinN?=U=XNFd=ZIwGyS(u3AlbzSg1u_-oLbt
zuwqbboe4NmH^c8KVvH0kgyr*XhBSusC3!Uv4ftz#>HC~Pi)uX4d%yP<7Wy~s45Vrk
z{Nk#ltmzZiDF_WuXbqOwO-E$k^ESftFu-#Oh@e#eOfo`4RnVD<@B7kyz;F!#s&HW&
zG1Fym$6K50%xE;kMVHzS#EE&>c_9k*f3JMie#Yo)l@DIsCS5JVOJ6+OW^O$mM+|)9
z2=!`{XotOtq$9%maDlh^Fc*_5L`Ki2>*hRkWX=ekRMEo6RXYB)yXNm8mXfhi?9i!<
z!LNY<H_y4#6C@c0)^<Ce5&B-m)$Ft&&~|cHNW+Jv<vy)h^`2CS<0|Dits8%x?!|)C
zWZJ1k!ov1TxK7S<%7ya-cXS!OvugX4ON_Y+4-|3Pf;P2o4bVHvQlV}sl&SvQexb|N
zc%fC7+}kYWSa2nfr|;)@?Aqyds%p0@A!S-$gTd=F_F11G#e7yhqVV*7cEB^KqS2q7
z>z--m*|eU`1pm0t;}(6e9WOL(Cpc;<<4He77m%}P_ZuEcSLMz!?9wj^VH7C_R=S4h
z-v|-tG%rd>I!Goy?Si%|pbvJPghdLU(r`(U@=~Bb&HHI*d?&pOXInUICgWRkxZ&()
zJ1CWpEWDs?*LdItazKtC;(tiQ{_BU{|0kbN`M<i}nYI%u0{}7r>@T-3(>e=R__|Di
zI3Ky_MjxnB5(2~MzoksI!mtj49#HtmH#8yt%0rvT2>*LZVusJW5(_R8a#x|Ug&)|L
zLT;Ipo>$3~%ZV35!3_p4d^z{0^|eU?ekf4`HqEV{o4E%YoCfwwO9T-^Iq3k8D1kVD
zPB;QX29^T@{MSsahUi}~2puyZK<xfuyKa6&2<z!8>-@bcpV%D#l7~uq3IIrx^YP1v
z|KLI;X!5>`j+s)&0|4NGl7qHpvoR~*m_~9kd+|E5;40sGSLlH2qGfEGj9~<zcfYOI
z@VqJvmTrLu_Gl<)`XU`8<J6rI+G!g43^gJf`J#Je<pmIju^ra4ji5FJ+LUpni!J&L
zF?mw{;lrmacx>_(axo2;P@IosaL%G_$4`P~dV4IAuo8wK(cR|g9kcsGDRMXbbw^5n
z{l(WK)#Ss{5e!)up|v|OPr0+H&6QnN)k>l#7KUiKwbBI976ImycU15|#~ba2@R*~I
zxlZUeKjP2y$9m~ggeidM@{I)qzFGAd%~R6KWHF^8?_)36e<b)QHzR4snkl&oJ&zh2
za$r3(YOTif(G-p*z0y;>FN0^xTms9Gn?ixmd3R1H-{n6J8MgKGPT?3p99OAl(APK>
zi<^VQAMmHNZVlP?^zijIH(UB!zk8ukm2RBBHMRzd3E3h-jM1-4L|e6()haEz$@Em_
zo8k-&8x$k7{(cCjWz9|hktqRn!5L3|A;zEIXdUa0NRjJ&f9xRS@?rTPOa^Tl;|$cJ
zQ<`NsS)?jx(b`%8Yp8l`n>NCNp%o5|nMGdc-}4YNl1Vl@dFB$X(=z-*QEba;-$s%h
z{X|D<i&OO+H@JN@+Ybe;)0g$IQ}&q!0rn>=?&+NI>mdf{ErLMHny*^V9M;khR&4TW
zA5x6bv#bo3=KPd=T-@Qc!!58|NLXml_*1hJoskou-qRROZvqMM5})1Fr=|j!OE11j
z<gpW4lfC;SdNq}@l7+;q(8?R$%w+b*kdy8oShqZlAJV+BEG|rOM<3A2nx({ce_CLo
zc{5F+8ft!K2#NeQl$T<qmemhsl8R$6ym{%lU5<ArFI0^v$-8gs&LtIUz~>DQkJdHC
zf?rpbRc)tYnuoyCo=tigHSDu~eO{G_FX|=cGJA~heOg{dk=_JvW-HJ8cxYPq9(n-t
zQ9}=VF7N&ktA5w;NMfM^8Q6{RH79*Q@*V)^2TYrxuejmi&OGVInhgUju!y8+$@!6K
zPLyAMqrI21Jy370418?y6GoX{XC2F#Zem$l;R+0;r`S^}IsJn$P(B6yFdT#r_VK)K
z&w*XL_2Z=)`UXpUZ~Tj3v$~}P;yAA*A*#qWmet_Lx@!EUgK+%89TK<?2U}e|86R@p
z5O^Mlj}64}9~6a`a@vi3R%PaxmnI*k;sQ^ei%fn%Zx|G71i$)SrO_Zc2zyrB2wTj!
z8e2msjqga4?@0i025&SWO&a3`X7-->1wCg7FDqI}O7W6<&4wb>IBfwC8AFo`yLRti
z&xwG4$6kCTO3Bw>KK%#rcjh(PG|V5UU<Y>9Lm5L{ilKV>35XcqLhDRbGN+NRTyI3V
zBb=Hb{7}ai714t&t4hTm-v8t-g_EjPL^(Fc^Ez{)xYXOy|Kclf(*3$Df>}x`!M!IO
zg6b&W3@&bRv_YMI!pQhkeX6|{g%3dW9x>I(U+`IU3oQ2)!%7YtccFJx9gIw6(CId>
zF$ZR?=j_jy3p+sQ!Q&uor0lH`8sDgEl{npB9Z0P*9%qPz_kQh3lwl{7t2GezqUz)#
zr?@PI0i37S225o#1C{>@0dY9#9^tfg(}li;;FheK3iP$6n>=n?A$tn}0LTadcM|`P
z|LTqTBB3U2@MpkR<*IB}NX2*GH>3x*QQDJ)A8Fm#i1z81g;)gtM~>(J`yqeQut8-A
zZ;9+f>k0Xuu?i*xuDMSSPji~O6yyldvh8eIC?LZ3C@T(zEYS`4DD85hph;X9Am?{m
zH!kRLjfUM)z5<A;r&Y1Z+@cUF<RxmB<ebM(`}60&M-HD2&pS@ZD%kce^%MWnn(Fgv
zM%mz_nqfv^KJ)x;7*x8gC=;X462N*6C&Q^JkU-f~latTV8N!WyZ<ZNHplsKB7awJ^
zJWwuAXllx<mCp}T^AoK=0kCz?+Q7vMcVO^iQ+=&C|9q)S0Spiiqh>t_2Hec59>!o%
wA^h=gw=)4*XG=2wC^FIQr-9o4X8zZfX9uaygTh3d{i7?%zj;+5XZq!T0nLIfGXMYp


From de25f2e937e45e3a3efcfd4a94495f893d16b4cd Mon Sep 17 00:00:00 2001
From: Kyle Gach <kyle.gach@gmail.com>
Date: Tue, 30 Jan 2024 10:14:55 -0700
Subject: [PATCH 6/7] Clarify subcomponents limitations

---
 docs/writing-stories/stories-for-multiple-components.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/writing-stories/stories-for-multiple-components.md b/docs/writing-stories/stories-for-multiple-components.md
index f03ec9a3c8e0..708ccce28787 100644
--- a/docs/writing-stories/stories-for-multiple-components.md
+++ b/docs/writing-stories/stories-for-multiple-components.md
@@ -26,10 +26,10 @@ Note that by adding a `subcomponents` property to the default export, we get an
 
 ![Subcomponents in ArgTypes doc block](./doc-block-arg-types-subcomponents-for-list.png)
 
-The downside of the approach used above, where each story creates its own combination of components, is that it does not take advantage of Storybook [Args](../writing-stories/args.md) meaning:
+Subcomponents are only intended for documentation purposes and have some limitations:
 
-1. You cannot change the stories via the controls panel
-2. There is no [args reuse](../writing-stories/index.md#using-args) possible, which makes the stories harder to maintain.
+1. The [argTypes](../api/arg-types.md) of subcomponents are [inferred (for the renderers that support that feature)](../api/arg-types.md#automatic-argtype-inference) and cannot be manually defined or overridden.
+2. The table for each documented subcomponent does _not_ include [controls](../essentials/controls.md) to change the value of the props, because controls always apply to the main component's args.
 
 Let's talk about some techniques you can use to mitigate the above, which are especially useful in more complicated situations.
 

From a96d34843e2b34c69444a409a09fd6ad61ea8bd8 Mon Sep 17 00:00:00 2001
From: Kyle Gach <kyle.gach@gmail.com>
Date: Tue, 30 Jan 2024 10:20:01 -0700
Subject: [PATCH 7/7] Update Vue snippets

---
 docs/snippets/vue/list-story-with-sub-components.js.mdx    | 7 +++++--
 .../snippets/vue/list-story-with-sub-components.ts-4-9.mdx | 7 +++++--
 docs/snippets/vue/list-story-with-sub-components.ts.mdx    | 7 +++++--
 3 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/docs/snippets/vue/list-story-with-sub-components.js.mdx b/docs/snippets/vue/list-story-with-sub-components.js.mdx
index 0c6e082e6a92..a19b58f3b3d1 100644
--- a/docs/snippets/vue/list-story-with-sub-components.js.mdx
+++ b/docs/snippets/vue/list-story-with-sub-components.js.mdx
@@ -16,9 +16,12 @@ export const Empty = {
 };
 
 export const OneItem = {
-  render: () => ({
+  render: (args) => ({
     components: { List, ListItem },
-    template: '<List><ListItem /></List>',
+    setup() {
+      return { args }
+    }
+    template: '<List v-bind="args"><ListItem /></List>',
   }),
 };
 ```
diff --git a/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx b/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
index 7d9c073bfa83..6e99a25445df 100644
--- a/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
+++ b/docs/snippets/vue/list-story-with-sub-components.ts-4-9.mdx
@@ -21,9 +21,12 @@ export const Empty: Story = {
 };
 
 export const OneItem: Story = {
-  render: () => ({
+  render: (args) => ({
     components: { List, ListItem },
-    template: '<List><ListItem /></List>',
+    setup() {
+      return { args }
+    }
+    template: '<List v-bind="args"><ListItem /></List>',
   }),
 };
 ```
diff --git a/docs/snippets/vue/list-story-with-sub-components.ts.mdx b/docs/snippets/vue/list-story-with-sub-components.ts.mdx
index b299d5350314..87ae30aed24a 100644
--- a/docs/snippets/vue/list-story-with-sub-components.ts.mdx
+++ b/docs/snippets/vue/list-story-with-sub-components.ts.mdx
@@ -21,9 +21,12 @@ export const Empty: Story = {
 };
 
 export const OneItem: Story = {
-  render: () => ({
+  render: (args) => ({
     components: { List, ListItem },
-    template: '<List><ListItem /></List>',
+    setup() {
+      return { args }
+    }
+    template: '<List v-bind="args"><ListItem /></List>',
   }),
 };
 ```