diff --git a/docs/api/doc-block-controls.md b/docs/api/doc-block-controls.md
index d199c1f3ec99..fa753933cb31 100644
--- a/docs/api/doc-block-controls.md
+++ b/docs/api/doc-block-controls.md
@@ -31,7 +31,7 @@ import * as ButtonStories from './Button.stories'
-The Controls doc block will only have functioning UI controls if you have also installed and registered [`@storybook/addon-controls`](../essentials/controls.md) (included in [`@storybook/addon-essentials`](../essentials/index.md)).
+The Controls doc block will only have functioning UI controls if you have also installed and registered [`@storybook/addon-controls`](../essentials/controls.md) (included in [`@storybook/addon-essentials`](../essentials/index.md)) and haven't turned off inline stories with the [`inline`](./doc-block-story.md#inline) configuration option.
diff --git a/docs/api/doc-block-source.md b/docs/api/doc-block-source.md
index c4a460050430..1c4c68c50517 100644
--- a/docs/api/doc-block-source.md
+++ b/docs/api/doc-block-source.md
@@ -98,6 +98,18 @@ Light mode is only supported when the `Source` block is rendered independently.
+
+
+### `excludeDecorators`
+
+Type: `boolean`
+
+Default: `parameters.docs.source.excludeDecorators`
+
+Determines if [decorators](../writing-stories/decorators.md) are rendered in the source code snippet.
+
+
+
### `format`
Type: `boolean | 'dedent' | BuiltInParserName`
diff --git a/docs/api/doc-block-story.md b/docs/api/doc-block-story.md
index 0a3470429ace..179d683a2f4a 100644
--- a/docs/api/doc-block-story.md
+++ b/docs/api/doc-block-story.md
@@ -96,6 +96,12 @@ Default: `parameters.docs.story.inline` or `true` (for [supported frameworks](..
Determines whether the story is rendered `inline` (in the same browser frame as the other docs content) or in an iframe.
+
+
+Setting the `inline` option to false will prevent the associated [controls](./doc-block-controls.md) from updating the story within the documentation page. This is a known limitation of the current implementation and will be addressed in a future release.
+
+
+
### `meta`
Type: CSF file exports
diff --git a/docs/writing-docs/autodocs.md b/docs/writing-docs/autodocs.md
index 96c42c8ba831..4e066de59f64 100644
--- a/docs/writing-docs/autodocs.md
+++ b/docs/writing-docs/autodocs.md
@@ -286,6 +286,10 @@ Additionally, if you're developing using TypeScript, you may need to update Stor
If you're still encountering issues, we recommend reaching out to the community using the default communication channels (e.g., [GitHub discussions](https://github.com/storybookjs/storybook/discussions/new?category=help)).
+### The controls are not updating the story within the auto-generated documentation
+
+If you turned off inline rendering for your stories via the [`inline`](../api/doc-block-story.md#inline) configuration option, you would run into a situation where the associated controls are not updating the story within the documentation page. This is a known limitation of the current implementation and will be addressed in a future release.
+
#### Learn more about Storybook documentation
- Autodocs for creating documentation for your stories
diff --git a/docs/writing-docs/mdx.md b/docs/writing-docs/mdx.md
index bd31e66374a0..cfe98b9bc4a7 100644
--- a/docs/writing-docs/mdx.md
+++ b/docs/writing-docs/mdx.md
@@ -455,6 +455,10 @@ Additionally, if you're working with VSCode, you can add the [MDX extension](htt
If you're still encountering issues, we recommend reaching out to the community using the default communication channels (e.g., [GitHub discussions](https://github.com/storybookjs/storybook/discussions/new?category=help)).
+### The controls are not updating the story within the MDX documentation page
+
+If you turned off inline rendering for your stories via the [`inline`](../api/doc-block-story.md#inline) configuration option, you would run into a situation where the associated controls are not updating the story within the documentation page. This is a known limitation of the current implementation and will be addressed in a future release.
+
#### Learn more about Storybook documentation
- [Autodocs](./autodocs.md) for creating documentation for your stories