Update doc card spec to place markup in first sentence

sserrata · sserrata · commit 99017758a091 · 2025-07-02T13:38:21.000-05:00
diff --git a/demo/examples/tests/docCards.yaml b/demo/examples/tests/docCards.yaml
@@ -6,9 +6,8 @@ paths:
   /docs:
     get:
       summary: Doc card operation
-      description: |
-        Returns documentation.
-        Supports **markdown** and <b>HTML</b> in descriptions.
+      description: >
+        Returns documentation with **markdown** and <b>HTML</b> in descriptions.
       tags:
         - docCards
       responses:
diff --git a/packages/docusaurus-plugin-openapi-docs/src/openapi/__fixtures__/docCards/openapi.yaml b/packages/docusaurus-plugin-openapi-docs/src/openapi/__fixtures__/docCards/openapi.yaml
@@ -6,9 +6,8 @@ paths:
   /docs:
     get:
       summary: Doc card operation
-      description: |
-        Returns documentation.
-        Supports **markdown** and <b>HTML</b> in descriptions.
+      description: >
+        Returns documentation with **markdown** and <b>HTML</b> in descriptions.
       tags:
         - docCards
       responses:
