docs: added documentation pages for experimental features (#5671)

* docs: added documentation pages for experimental features

* fix content lint issues

* fixed lint errors

* added migration step

* added workflows introduction

* add installation guides

* added installation guides for modules + generated workflows reference

* added missing workflows reference link

* Added warning message for experimental features

* fix note

docs-util/packages/typedoc-config/extended-tsconfig/workflows.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json.schemastore.org/tsconfig",
   "extends": [
-    "../../../../packages/workflows/tsconfig.json"
+    "../../../../packages/workflows-sdk/tsconfig.json"
   ]
 }

docs-util/packages/typedoc-config/workflows.js

@@ -7,12 +7,12 @@ const pathPrefix = path.join(__dirname, "..", "..", "..")
 module.exports = {
   ...globalTypedocOptions,
   entryPoints: [
-    path.join(pathPrefix, "packages/workflows/src/utils/composer/index.ts"),
+    path.join(pathPrefix, "packages/workflows-sdk/src/utils/composer/index.ts"),
   ],
   out: [path.join(pathPrefix, "www/apps/docs/content/references/workflows")],
   tsconfig: path.join(__dirname, "extended-tsconfig", "workflows.json"),
-  name: "Workflows Reference",
-  indexTitle: "Workflows Reference",
+  name: "Workflows API Reference",
+  indexTitle: "Workflows API Reference",
   entryDocument: "index.mdx",
   hideInPageTOC: true,
   hideBreadcrumbs: true,
@@ -43,6 +43,8 @@ module.exports = {
       },
     },
     "index\\.mdx": {
+      reflectionDescription:
+        "This section of the documentation provides a reference to the utility functions of the `@medusajs/workflows-sdk` package.",
       reflectionGroups: {
         Namespaces: false,
         Enumerations: false,
@@ -55,6 +57,18 @@ module.exports = {
     },
     functions: {
       maxLevel: 1,
+      reflectionDescription:
+        "This documentation provides a reference to the `{{alias}}` {{kind}}. It belongs to the `@medusajs/workflows-sdk` package.",
+      frontmatterData: {
+        displayed_sidebar: "workflowsSidebar",
+        slug: "/references/workflows/{{alias}}",
+        sidebar_label: "{{alias}}",
+      },
+      reflectionTitle: {
+        kind: false,
+        typeParameters: false,
+        suffix: "- Workflows Reference",
+      },
     },
     "classes/StepResponse": {
       reflectionGroups: {