docs: updates following authentication flow changes (#8706)

* docs: updates following authentication flow changes

* generate sidebar

* added open api specs

* fix up OAS

* changes to existing pages

* change sidebar items

* update marketplace recipe

www/apps/resources/sidebar.mjs

@@ -94,7 +94,7 @@ export const sidebar = sidebarAttachHrefCommonOptions([
         children: [
           {
             type: "link",
-            path: "/commerce-modules/api-key",
+            path: "/commerce-modules/auth",
             title: "Overview",
           },
           {
@@ -129,14 +129,20 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                 ],
               },
               {
-                type: "link",
-                path: "/commerce-modules/auth/authentication-route",
-                title: "Authentication Route",
-              },
-              {
-                type: "link",
-                path: "/commerce-modules/auth/auth-flows",
+                type: "sub-category",
                 title: "Auth Flows",
+                children: [
+                  {
+                    type: "link",
+                    path: "/commerce-modules/auth/authentication-route",
+                    title: "Using API Routes",
+                  },
+                  {
+                    type: "link",
+                    path: "/commerce-modules/auth/auth-flows",
+                    title: "Using Module's Service",
+                  },
+                ],
               },
             ],
           },