Sync open source content 🐝 (from ce97345fca69dfb1e56e2fd678cf33caee93c2d2)

Author: beezythebot

docs/sdks/sdk-docs/integrations/_get-public-url-snippet.mdx

@@ -4,26 +4,24 @@ import { Screenshot } from "@/mdx/components";
 
 ### Get the API's combined spec public URL from the registry
 
-Navigate to the [Speakeasy Dashboard](https://app.speakeasy.com) and open the **API Registry** overview. Select the relevant API and open the entry labeled with type `Combined Spec`. This is typically at the bottom under "Related Documents".
+Navigate to the [Speakeasy Dashboard](https://app.speakeasy.com) and click on the **Docs** tab. Select the **Integrate with a Docs Provider** option.
 
-<Screenshot 
+<Screenshot
   variant="web"
   image={{
-    src: '/assets/docs/code-samples/openapi-registry-and-combined-spec.png',
-    alt: "Screenshot showing the Speakeasy API Registry page"
+    src: '/assets/docs/code-samples/integrate-with-docs-provider.png',
+    alt: "Screenshot showing the Speakeasy Dashboard Docs tab with Integrate with a Docs Provider option"
   }}
 />
 
-> NOTE: If the entry is not labeled **Combined Spec**, ensure that the API
-> has an [automatic code sample
-> URL](/docs/sdk-docs/code-samples/automated-code-sample-urls) configured.
+On the **Integrate with a Docs Provider** page, select the correct OpenAPI document using the **Change OpenAPI Documents** button. Then, copy the Spec URL.
 
-From the registry entry's page, copy the provided public URL using the "Share" button on the top right.
-
-<Screenshot 
+<Screenshot
   variant="web"
   image={{
-    src: '/assets/docs/code-samples/copy-combined-spec-url.png',
-    alt: "Screenshot showing the combined spec registry entry with the share function highlighted."
+    src: '/assets/docs/code-samples/copy-spec-url.png',
+    alt: "Screenshot showing the Integrate with a Docs Provider page with the Spec URL to copy"
   }}
 />
+
+Make sure the **Public** toggle is enabled, so Mintlify can access the OpenAPI document.

docs/sdks/sdk-docs/integrations/mintlify.mdx

@@ -18,7 +18,7 @@ Autogenerated code snippets from Speakeasy SDKs can be integrated directly into
   variant="web"
   url="docs.myapi.com"
   image={{
-    src: "/assets/docs/code-samples/mintlify-with-speakeasy-openapi.png",
+    src: "/assets/docs/code-samples/mintlify-with-speakeasy-code-snippets.png",
     alt: "Speakeasy code snippets with Mintlify.",
   }}
 />
@@ -38,8 +38,6 @@ To integrate Mintlify with Speakeasy, you'll need the following:
 
 Add the combined spec URL to **Anchors** or **Tabs** in the `docs.json` configuration file of a Mintlify repository.
 
-**Note:** Mintlify now uses `docs.json` as the primary configuration file. If you're still using the legacy `mint.json` format, follow the [migration guide](https://mintlify.com/docs/settings#upgrading-from-mintjson) to upgrade to `docs.json`.
-
 #### Using docs.json
 
 Add the combined spec URL to **Anchors** by updating the `anchor` field in the `docs.json` file as follows:
@@ -49,10 +47,9 @@ Add the combined spec URL to **Anchors** by updating the `anchor` field in the `
   "anchors": [
     {
       "name": "API Reference",
-      // !mark
-      "openapi": "SPEAKEASY_COMBINED_SPEC_URL",
       "url": "api-reference",
-      "icon": "square-terminal"
+      "icon": "square-terminal",
+      "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
     }
   ]
 }
@@ -66,7 +63,6 @@ Add the combined spec URL to **Tabs** by updating the `tab` field in the `docs.j
     {
       "name": "API Reference",
       "url": "api-reference",
-      // !mark
       "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
     }
   ]