From 702555242d50821caa7c9edb3803eabeedb6407b Mon Sep 17 00:00:00 2001
From: Ben Brooks <bbrooks@bitwarden.com>
Date: Mon, 21 Jul 2025 07:43:34 -0700
Subject: [PATCH] fix: [CL-601] Add storybook description

Signed-off-by: Ben Brooks <bbrooks@bitwarden.com>
---
 libs/components/src/search/search.component.ts | 3 +++
 libs/components/src/search/search.mdx          | 3 ++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/libs/components/src/search/search.component.ts b/libs/components/src/search/search.component.ts
index 24e68961580..84730c76eed 100644
--- a/libs/components/src/search/search.component.ts
+++ b/libs/components/src/search/search.component.ts
@@ -17,6 +17,9 @@ import { FocusableElement } from "../shared/focusable-element";
 
 let nextId = 0;
 
+/**
+ * Do not nest Search components inside another `<form>`, as they already contain their own standalone `<form>` element for searching.
+ */
 @Component({
   selector: "bit-search",
   templateUrl: "./search.component.html",
diff --git a/libs/components/src/search/search.mdx b/libs/components/src/search/search.mdx
index 7775225b8c2..98e91162c94 100644
--- a/libs/components/src/search/search.mdx
+++ b/libs/components/src/search/search.mdx
@@ -1,4 +1,4 @@
-import { Meta, Canvas, Source, Primary, Controls, Title } from "@storybook/addon-docs";
+import { Meta, Canvas, Source, Primary, Controls, Title, Description } from "@storybook/addon-docs";
 
 import * as stories from "./search.stories";
 
@@ -9,6 +9,7 @@ import { SearchModule } from "@bitwarden/components";
 ```
 
 <Title>Search field</Title>
+<Description />
 
 <Primary />
 <Controls />