Sync open source content 🐝 (from cdaad59f546603080c7e4ccc405ff50402b70fd2)

Author: beezythebot

docs/prep-openapi/overlays/create-overlays.mdx

@@ -4,7 +4,7 @@ sidebar_label: Create Overlays
 description: "Overlays are a quick and easy way to implement changes to an OpenAPI document. Learn how overlays work and how to use them."
 ---
 
-import { Spotlight, Callout } from "@/mdx/components";
+import { Callout, Spotlight } from "@/mdx/components";
 
 # Create overlays
 
@@ -20,11 +20,11 @@ These customizations apply to an OpenAPI document in a new file, ensuring API sp
 
 Overlays enable various customizations to API specifications. Common scenarios include:
 
-- [Adding Speakeasy extensions](/examples/sdk-generation/overlays/overlays#adding-speakeasy-extensions): Enhance OpenAPI documents with custom Speakeasy extensions for additional functionality or metadata
-- [Adding examples to API documentation](/examples/sdk-generation/overlays/overlays#adding-examples-to-api-documentation): Provide clear, concrete examples to clarify API usage
-- [Hiding internal APIs from a public SDK](/examples/sdk-generation/overlays/overlays#hiding-internal-apis-from-a-public-sdk): Exclude internal API endpoints from public-facing SDK documentation for security and clarity
+- [Adding Speakeasy extensions](/guides/sdks/overlays/overlays#adding-speakeasy-extensions): Enhance OpenAPI documents with custom Speakeasy extensions for additional functionality or metadata
+- [Adding examples to API documentation](/guides/sdks/overlays/overlays#adding-examples-to-api-documentation): Provide clear, concrete examples to clarify API usage
+- [Hiding internal APIs from a public SDK](/guides/sdks/overlays/overlays#hiding-internal-apis-from-a-public-sdk): Exclude internal API endpoints from public-facing SDK documentation for security and clarity
 
-[View more examples here](/examples/sdk-generation/overlays/overlays).
+[View more examples here](/guides/sdks/overlays/overlays).
 
 ## Creating an overlay
 
@@ -39,10 +39,10 @@ speakeasy overlay compare --before=./openapi_original.yaml --after=./openapi.yam
 ```
 
 <Callout title="Using compare" type="info">
-  The compare feature helps identify differences across
-  OpenAPI documents. Precise adjustments may require
-  manual refinement of the generated overlay file. Validate
-  and evaluate JSONPath expressions [here](https://jsonpath.com/).
+  The compare feature helps identify differences across OpenAPI documents.
+  Precise adjustments may require manual refinement of the generated overlay
+  file. Validate and evaluate JSONPath expressions
+  [here](https://jsonpath.com/).
 </Callout>
 
 ## Anatomy of an overlay
@@ -201,9 +201,17 @@ actions:
 
 ## Helpful references:
 
-- [Common overlay examples](/examples/sdk-generation/overlays/overlays)
-- [Common JSONPath examples](/examples/sdk-generation/overlays/json-path-expressions)
+- [Common overlay examples](/guides/sdks/overlays/overlays)
+- [Common JSONPath examples](/guides/sdks/overlays/json-path-expressions)
 
 <Callout title="Try Speakeasy's OpenAPI Overlay Playground" type="info">
-  For a visual approach to creating or editing overlays, visit <a href="https://overlay.speakeasy.com/" target="_blank" rel="noopener noreferrer">overlay.speakeasy.com</a>.
+  For a visual approach to creating or editing overlays, visit{" "}
+  <a
+    href="https://overlay.speakeasy.com/"
+    target="_blank"
+    rel="noopener noreferrer"
+  >
+    overlay.speakeasy.com
+  </a>
+  .
 </Callout>