From 28cf4ee6da8b74a7ec1a59b8deda7d31bf424d07 Mon Sep 17 00:00:00 2001
From: David Hill <dh366k@us.att.com>
Date: Tue, 29 Jun 2021 14:34:20 +0100
Subject: [PATCH 1/5] Document how to add idividual story description, see
 #8527 #10823

---
 addons/docs/docs/recipes.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/addons/docs/docs/recipes.md b/addons/docs/docs/recipes.md
index e0cb01621058..570966fc8806 100644
--- a/addons/docs/docs/recipes.md
+++ b/addons/docs/docs/recipes.md
@@ -336,6 +336,22 @@ import { theme } from '../path/to/theme'
 Rest of your file...
 ```
 
+## Add doc to individual stories
+
+Add `storyDescription` to `parameters.docs`
+
+```js
+const Example = () => <Button />;
+
+Example.parameters = {
+  docs: {
+    storyDescription: "Individiual story description, may conatin `markdown` markup",
+  },
+};
+```
+
+There is also an webpack loader package that extracts descriptions from jsdoc comments [story-description-loader](https://www.npmjs.com/package/story-description-loader)
+
 ## More resources
 
 - References: [README](../README.md) / [DocsPage](docspage.md) / [MDX](mdx.md) / [FAQ](faq.md) / [Recipes](recipes.md) / [Theming](theming.md) / [Props](props-tables.md)

From af319f6c6ebafbcb7113bb0105e5fdd145897deb Mon Sep 17 00:00:00 2001
From: David Hill <dh366k@us.att.com>
Date: Tue, 29 Jun 2021 14:41:44 +0100
Subject: [PATCH 2/5] Add link in contents

---
 addons/docs/docs/recipes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/addons/docs/docs/recipes.md b/addons/docs/docs/recipes.md
index 570966fc8806..36e13bf3a329 100644
--- a/addons/docs/docs/recipes.md
+++ b/addons/docs/docs/recipes.md
@@ -17,6 +17,7 @@
 - [Reordering Docs tab first](#reordering-docs-tab-first)
 - [Customizing source snippets](#customizing-source-snippets)
 - [Overwriting docs container](#overwriting-docs-container)
+- [Add doc to individual stories](#add-doc-to-individual-stories)
 - [More resources](#more-resources)
 
 ## Component Story Format (CSF) with DocsPage

From 79449924acb2829f559aacedb838cb65aea6b5af Mon Sep 17 00:00:00 2001
From: David Hill <dh366k@us.att.com>
Date: Tue, 29 Jun 2021 14:45:26 +0100
Subject: [PATCH 3/5] Fix bad title

---
 addons/docs/docs/recipes.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/addons/docs/docs/recipes.md b/addons/docs/docs/recipes.md
index 36e13bf3a329..9942e00fa417 100644
--- a/addons/docs/docs/recipes.md
+++ b/addons/docs/docs/recipes.md
@@ -17,7 +17,7 @@
 - [Reordering Docs tab first](#reordering-docs-tab-first)
 - [Customizing source snippets](#customizing-source-snippets)
 - [Overwriting docs container](#overwriting-docs-container)
-- [Add doc to individual stories](#add-doc-to-individual-stories)
+- [Add description to individual stories](#add-description-to-individual-stories)
 - [More resources](#more-resources)
 
 ## Component Story Format (CSF) with DocsPage
@@ -337,7 +337,7 @@ import { theme } from '../path/to/theme'
 Rest of your file...
 ```
 
-## Add doc to individual stories
+## Add description to individual stories
 
 Add `storyDescription` to `parameters.docs`
 

From 13bcbe532ddb554894f009392eb4f9692916999f Mon Sep 17 00:00:00 2001
From: David Hill <dh366k@us.att.com>
Date: Tue, 29 Jun 2021 15:03:02 +0100
Subject: [PATCH 4/5] Update directions to new recommended version

---
 addons/docs/docs/recipes.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/addons/docs/docs/recipes.md b/addons/docs/docs/recipes.md
index 9942e00fa417..ed8b0ffd6e6e 100644
--- a/addons/docs/docs/recipes.md
+++ b/addons/docs/docs/recipes.md
@@ -346,7 +346,9 @@ const Example = () => <Button />;
 
 Example.parameters = {
   docs: {
-    storyDescription: "Individiual story description, may conatin `markdown` markup",
+    description: {
+      story: "Individiual story description, may conatin `markdown` markup"
+    },
   },
 };
 ```

From e1a4b2c96f54399dc5c27b0a6fbda1cf4dc92b1c Mon Sep 17 00:00:00 2001
From: Michael Shilman <shilman@users.noreply.github.com>
Date: Wed, 30 Jun 2021 15:24:17 +0800
Subject: [PATCH 5/5] Update addons/docs/docs/recipes.md

---
 addons/docs/docs/recipes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/addons/docs/docs/recipes.md b/addons/docs/docs/recipes.md
index ed8b0ffd6e6e..6cb8cc6cb578 100644
--- a/addons/docs/docs/recipes.md
+++ b/addons/docs/docs/recipes.md
@@ -339,7 +339,7 @@ Rest of your file...
 
 ## Add description to individual stories
 
-Add `storyDescription` to `parameters.docs`
+Add `story` to `docs.description` parameter
 
 ```js
 const Example = () => <Button />;