docs: improve content of workflows reference overview page (#11045)

www/utils/packages/typedoc-generate-references/src/constants/merger-custom-options/core-flows.ts

@@ -47,6 +47,7 @@ const coreFlowsOptions: FormattingOptionsType = {
     frontmatterData: {
       slug: "/references/medusa-workflows/{{alias}}",
       sidebar_label: "{{alias}}",
+      sidebar_description: "{{summary}}",
     },
     reflectionTitle: {
       kind: false,

www/utils/packages/typedoc-plugin-markdown-medusa/src/utils/reflection-template-strings.ts

@@ -21,6 +21,13 @@ export function replaceTemplateVariables(
       reflection.parent?.parent?.name || ""
     )
     .replaceAll("{{kind}}", getKindAsText(reflection.kind))
+    .replaceAll(
+      "{{summary}}",
+      reflection.comment?.blockTags
+        .find((tag) => tag.tag === "@summary")
+        ?.content.map((content) => content.text)
+        .join(" ") || ""
+    )
 }
 
 export function getKindAsText(kind: ReflectionKind) {