Sync open source content 🐝 (from 1a077c4828798c6b088b083c74cdaa1a77b194c1)

Author: beezythebot

api-design/developer-experience.mdx

@@ -189,4 +189,4 @@ By following these principles, an API will be something that developers actually
 
 ### Further reading
 
-To learn more about API design, [check out our guide to API design best practices](/post/api-design).
+To learn more about API design, [check out our guide to API design best practices](/blog/api-design).

api-design/testing.mdx

@@ -35,7 +35,7 @@ It's not exactly a pyramid, but you get the idea.
 
 At the base, we have **unit tests**. These are the tests that verify the internal workings of your API. They're important for maintaining code quality and catching regressions, but they don't tell us much about how the API behaves from a consumer's perspective, so we'll limit their scope and keep them private.
 
-In the middle, we've added **contract tests**. These tests verify that the API's contract with consumers is upheld. They're a step up from unit tests because they verify the API's behavior at its boundaries. We've covered contract testing in detail in a [previous post](https://www.speakeasy.com/post/contract-testing-with-openapi).
+In the middle, we've added **contract tests**. These tests verify that the API's contract with consumers is upheld. They're a step up from unit tests because they verify the API's behavior at its boundaries. We've covered contract testing in detail in a [previous post](/blog/contract-testing-with-openapi).
 
 We'll focus on **integration tests** at the top-middle layer of the pyramid. These tests verify the API's behavior from a consumer's perspective. They're the most relevant tests for API consumers because they show exactly how the API behaves in different scenarios.
 
@@ -415,7 +415,7 @@ While sharing your API's behavioral tests provides tremendous value, there are s
 
 ### Contract testing
 
-Investigate tools like [Pact](/post/pact-vs-openapi) that formalize the provider-consumer contract. These approaches complement public tests by allowing consumers to define their expectations explicitly.
+Investigate tools like [Pact](/blog/pact-vs-openapi) that formalize the provider-consumer contract. These approaches complement public tests by allowing consumers to define their expectations explicitly.
 
 ### Chaos testing
 

docs/sdks/create-client-sdks.mdx

@@ -158,7 +158,7 @@ Saved changes in the Studio automatically triggers a regeneration of the SDK loc
   }}
 />
 
-It is also possible to make changes without the Studio. Check out the following guide on [customizing SDKs](/docs/customize-sdks/) for all the details.
+It is also possible to make changes without the Studio. Check out the following guide on [customizing SDKs](/docs/sdks/customize/basics) for all the details.
 
 ## Next Step: Uploading the SDK to GitHub
 

docs/sdks/customize/typescript/configuring-module-format.mdx

@@ -102,4 +102,4 @@ For most projects, `esm` is the best choice. Most modern tooling supports ESM, a
 ## Additional reading
 
 - [TypeScript configuration options](/docs/gen-reference/ts-config)
-- [Lean SDKs with standalone functions](/post/standalone-functions)
+- [Lean SDKs with standalone functions](/blog/standalone-functions)

docs/sdks/customize/typescript/disabling-barrel-files.mdx

@@ -110,4 +110,4 @@ Whether you should use `useIndexModules` depends on your project's priorities:
 Visit the following pages to learn more about generating SDKs with Speakeasy:
 
 - [TypeScript configuration options](/docs/customize/typescript/configuring-module-format)
-- [Lean SDKs with standalone functions](/post/standalone-functions)
+- [Lean SDKs with standalone functions](/blog/standalone-functions)

docs/sdks/languages/golang/oss-comparison-go.mdx

@@ -141,7 +141,7 @@ To start our comparison, we installed all four generators on a local machine run
 
 ### Installing the OpenAPI Generator CLI
 
-OpenAPI Generator depends on Java, [which we covered at length previously](/post/speakeasy-oss-python-generator#our-experience-installing-the-openapi-generator-cli). We concluded that managing the OpenAPI Generator Java dependencies manually just wasn't worth the effort.
+OpenAPI Generator depends on Java, [which we covered at length previously](/docs/sdks/languages/python/oss-comparison-python#preparing-the-sdk-generators). We concluded that managing the OpenAPI Generator Java dependencies manually just wasn't worth the effort.
 
 Installing `openapi-generator` using Homebrew installs `openjdk@11` and its many dependencies:
 

docs/sdks/languages/java/oss-comparison-java.mdx

@@ -36,7 +36,7 @@ Below is a table that summarizes the key differences between the two SDKs:
   ]}
 />
 
-Read more about these headline features of Speakeasy-created Java SDKs in the [March 2024 release notes](/post/release-java-ga), or consult the [Speakeasy Java SDK documentation](/docs/languages/java/methodology-java).
+Read more about these headline features of Speakeasy-created Java SDKs in the [March 2024 release notes](/blog/release-java-ga), or consult the [Speakeasy Java SDK documentation](/docs/languages/java/methodology-java).
 
 For a detailed technical comparison, read on!
 

docs/sdks/languages/php/oss-comparison-php.mdx

@@ -6,7 +6,7 @@ import { Table } from "@/mdx/components";
 
 Many of our users have switched from [OpenAPI Generator](https://openapi-generator.tech/) to Speakeasy for their PHP SDKs. Learn how to use both SDK creators in this guide, and the differences between them.
 
-Open-source OpenAPI generators are great for experimentation but lack the reliability, performance, and intuitive developer experience required for critical applications. As an alternative, Speakeasy creates [idiomatic SDKs](/post/client-sdks-as-a-service) that meet the bar for enterprise use.
+Open-source OpenAPI generators are great for experimentation but lack the reliability, performance, and intuitive developer experience required for critical applications. As an alternative, Speakeasy creates [idiomatic SDKs](/blog/speakeasy-vs-openapi-generator) that meet the bar for enterprise use.
 
 Here's the high-level summary of the differences between Speakeasy and OpenAPI Generator:
 

docs/sdks/languages/python/methodology-python.mdx

@@ -8,7 +8,7 @@ import { FileTree } from "nextra/components";
 
 <Callout title="OSS Comparison" type="info">
   For a comparison between the Speakeasy Python SDK and some popular open-source
-  generators, see [**this page**](/post/speakeasy-oss-python-generator).
+  generators, see [**this page**](/docs/sdks/languages/python/oss-comparison-python).
 </Callout>
 
 ## SDK Overview

docs/sdks/languages/python/oss-comparison-python.mdx

@@ -9,13 +9,13 @@ import { Callout, Table } from "@/mdx/components";
 
 Many of our users have switched from [OpenAPI Generator](https://openapi-generator.tech/) to Speakeasy for their Python SDKs. Learn how to use both SDK creators in this guide, and the differences between them.
 
-Open-source OpenAPI generators are great for experimentation but lack the reliability, performance, and intuitive developer experience required for critical applications. As an alternative, Speakeasy creates [idiomatic SDKs](/post/client-sdks-as-a-service) that meet the bar for enterprise use.
+Open-source OpenAPI generators are great for experimentation but lack the reliability, performance, and intuitive developer experience required for critical applications. As an alternative, Speakeasy creates [idiomatic SDKs](/blog/speakeasy-vs-openapi-generator) that meet the bar for enterprise use.
 
 In this post, we'll focus on Python, but Speakeasy can also create SDKs in Go, TypeScript, Java, Ruby, PHP, and more.
 
 <Callout title="View More Comparisons" type="info">
-- [Read about the differences between TypeScript SDKs generated by Speakeasy and OpenAPI Generator.](/post/speakeasy-sdk-vs-openapi-typescript-generator/) <br/>
-- [Read about the differences between Go SDKs generated by Speakeasy and OpenAPI Generator.](/post/speakeasy-oss-go-generator)
+- [Read about the differences between TypeScript SDKs generated by Speakeasy and OpenAPI Generator.](/docs/sdks/languages/typescript/oss-comparison-ts) <br/>
+- [Read about the differences between Go SDKs generated by Speakeasy and OpenAPI Generator.](/docs/sdks/languages/golang/oss-comparison-go)
 </Callout>
 
 Here's a summary of the major differences between a Python SDK created using Speakeasy, compared to an SDK created by the OpenAPI Generator. Unless support for Python 3.9 or earlier is critically important, Speakeasy is recommended for Python SDKs.
@@ -507,7 +507,7 @@ The OpenAPI Generator class also has to include many boilerplate methods for Pyd
 
 ### Open enums
 
-Speakeasy allows adding the custom attribute `x-speakeasy-unknown-values` to an OpenAPI field to allow [open enums](/post/open-enums).
+Speakeasy allows adding the custom attribute `x-speakeasy-unknown-values` to an OpenAPI field to allow [open enums](/blog/open-enums).
 
 ```yaml
 status: