From b676585e90be66ba52e956db8c53a7d5b07203a4 Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Mon, 22 Dec 2025 19:30:30 +0000 Subject: [PATCH 1/3] Reorganize SDK Deep dives section into smaller sections Break up the large Deep dives section into three smaller, focused sections: - Configuration: global headers, auto-pagination, idempotency, retries, README - Customization: SDK user features, method names, dynamic auth, audiences - Development: local previews, testing, self-hosted This matches the organizational pattern used in the Docs product navigation. --- fern/products/sdks/sdks.yml | 47 +++++++++++++++++++++---------------- 1 file changed, 27 insertions(+), 20 deletions(-) diff --git a/fern/products/sdks/sdks.yml b/fern/products/sdks/sdks.yml index f23e80014..0a3d8008f 100644 --- a/fern/products/sdks/sdks.yml +++ b/fern/products/sdks/sdks.yml @@ -226,41 +226,48 @@ navigation: - page: Publishing to Postman path: ./overview/postman/publishing-to-postman.mdx slug: publishing - - section: Deep dives - contents: - - page: SDK user features - path: ./guides/generated-sdk.mdx - - page: Customize method names - path: ./guides/customize-method-names.mdx - slug: customize-method-names - - page: Setup local SDK previews - path: ./guides/setup-local-sdk-previews.mdx - slug: local-previews + - section: Configuration + collapsed: true + contents: - page: Configure global headers path: ./guides/configure-global-headers.mdx slug: global-headers - - page: Dynamic authentication - path: ./guides/dynamic-authentication.mdx - slug: dynamic-authentication - page: Configure auto-pagination path: ./guides/configure-auto-pagination.mdx slug: auto-pagination - page: Configure idempotency path: ./guides/configure-idempotency.mdx slug: idempotency - - page: Filter your endpoints (audiences) - path: ./guides/filter-your-endpoints-audiences.mdx - slug: audiences + - page: Retries with backoff + path: ./guides/retries-with-backoff.mdx - page: Customize your README path: ./guides/configure-readme.mdx slug: readme - - page: Retries with Backoff - path: ./guides/retries-with-backoff.mdx + - section: Customization + collapsed: true + contents: + - page: SDK user features + path: ./guides/generated-sdk.mdx + - page: Customize method names + path: ./guides/customize-method-names.mdx + slug: customize-method-names + - page: Dynamic authentication + path: ./guides/dynamic-authentication.mdx + slug: dynamic-authentication + - page: Filter your endpoints (audiences) + path: ./guides/filter-your-endpoints-audiences.mdx + slug: audiences + - section: Development + collapsed: true + contents: + - page: Setup local SDK previews + path: ./guides/setup-local-sdk-previews.mdx + slug: local-previews + - page: Testing + path: ./guides/testing.mdx - page: Self-hosted SDKs path: ./guides/self-hosted.mdx slug: self-hosted - - page: Testing - path: ./guides/testing.mdx - section: Reference contents: - page: generators.yml From 8218d5d231f65f7d4df4259567d2e9b4e8385f0b Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Mon, 22 Dec 2025 19:38:47 +0000 Subject: [PATCH 2/3] Improve SDK docs organization with content-based sections Reorganize the Deep dives section into five focused sections based on actual page content: - Generated SDK: SDK user features and README customization - SDK interface: Method names and audience filtering - Request behavior: Headers, auth, pagination, idempotency, retries - Preview & testing: Local previews and testing - Hosting: Self-hosted SDKs (Enterprise) Preserves existing /sdks/deep-dives/* URLs via explicit slugs for backward compatibility. --- fern/products/sdks/sdks.yml | 58 ++++++++++++++++++++++--------------- 1 file changed, 34 insertions(+), 24 deletions(-) diff --git a/fern/products/sdks/sdks.yml b/fern/products/sdks/sdks.yml index 0a3d8008f..e558ae398 100644 --- a/fern/products/sdks/sdks.yml +++ b/fern/products/sdks/sdks.yml @@ -226,48 +226,58 @@ navigation: - page: Publishing to Postman path: ./overview/postman/publishing-to-postman.mdx slug: publishing - - section: Configuration + - section: Generated SDK + slug: deep-dives collapsed: true contents: - - page: Configure global headers - path: ./guides/configure-global-headers.mdx - slug: global-headers - - page: Configure auto-pagination - path: ./guides/configure-auto-pagination.mdx - slug: auto-pagination - - page: Configure idempotency - path: ./guides/configure-idempotency.mdx - slug: idempotency - - page: Retries with backoff - path: ./guides/retries-with-backoff.mdx + - page: SDK user features + path: ./guides/generated-sdk.mdx + slug: sdk-user-features - page: Customize your README path: ./guides/configure-readme.mdx slug: readme - - section: Customization + - section: SDK interface collapsed: true contents: - - page: SDK user features - path: ./guides/generated-sdk.mdx - page: Customize method names path: ./guides/customize-method-names.mdx - slug: customize-method-names + slug: deep-dives/customize-method-names + - page: Filter endpoints by audience + path: ./guides/filter-your-endpoints-audiences.mdx + slug: deep-dives/audiences + - section: Request behavior + collapsed: true + contents: + - page: Global headers + path: ./guides/configure-global-headers.mdx + slug: deep-dives/global-headers - page: Dynamic authentication path: ./guides/dynamic-authentication.mdx - slug: dynamic-authentication - - page: Filter your endpoints (audiences) - path: ./guides/filter-your-endpoints-audiences.mdx - slug: audiences - - section: Development + slug: deep-dives/dynamic-authentication + - page: Auto-pagination + path: ./guides/configure-auto-pagination.mdx + slug: deep-dives/auto-pagination + - page: Idempotency headers + path: ./guides/configure-idempotency.mdx + slug: deep-dives/idempotency + - page: Retries with backoff + path: ./guides/retries-with-backoff.mdx + slug: deep-dives/retries-with-backoff + - section: Preview & testing collapsed: true contents: - - page: Setup local SDK previews + - page: Local SDK previews path: ./guides/setup-local-sdk-previews.mdx - slug: local-previews + slug: deep-dives/local-previews - page: Testing path: ./guides/testing.mdx + slug: deep-dives/testing + - section: Hosting + collapsed: true + contents: - page: Self-hosted SDKs path: ./guides/self-hosted.mdx - slug: self-hosted + slug: deep-dives/self-hosted - section: Reference contents: - page: generators.yml From 49faf8e3bebf97ebc7f8fadceda9c9cd80a9a389 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Mon, 22 Dec 2025 15:10:04 -0500 Subject: [PATCH 3/3] restructure, fix slugs --- fern/products/sdks/sdks.yml | 35 +++++++++++++++++++---------------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/fern/products/sdks/sdks.yml b/fern/products/sdks/sdks.yml index e558ae398..00543c91f 100644 --- a/fern/products/sdks/sdks.yml +++ b/fern/products/sdks/sdks.yml @@ -9,6 +9,11 @@ navigation: - page: Quickstart path: ./fern-folder.mdx slug: quickstart + - link: Customer showcase + href: https://buildwithfern.com/showcase + - section: Working with SDKs + slug: overview + contents: - page: Project structure path: ./project-structure.mdx slug: project-structure @@ -21,8 +26,6 @@ navigation: - page: Fern Autorelease path: ./autorelease.mdx slug: autorelease - - link: Customer showcase - href: https://buildwithfern.com/showcase - section: Generators contents: - section: TypeScript @@ -226,7 +229,7 @@ navigation: - page: Publishing to Postman path: ./overview/postman/publishing-to-postman.mdx slug: publishing - - section: Generated SDK + - section: SDK design slug: deep-dives collapsed: true contents: @@ -236,48 +239,48 @@ navigation: - page: Customize your README path: ./guides/configure-readme.mdx slug: readme - - section: SDK interface - collapsed: true - contents: - page: Customize method names path: ./guides/customize-method-names.mdx - slug: deep-dives/customize-method-names + slug: customize-method-names - page: Filter endpoints by audience path: ./guides/filter-your-endpoints-audiences.mdx - slug: deep-dives/audiences + slug: audiences - section: Request behavior + slug: deep-dives collapsed: true contents: - page: Global headers path: ./guides/configure-global-headers.mdx - slug: deep-dives/global-headers + slug: global-headers - page: Dynamic authentication path: ./guides/dynamic-authentication.mdx - slug: deep-dives/dynamic-authentication + slug: dynamic-authentication - page: Auto-pagination path: ./guides/configure-auto-pagination.mdx - slug: deep-dives/auto-pagination + slug: auto-pagination - page: Idempotency headers path: ./guides/configure-idempotency.mdx - slug: deep-dives/idempotency + slug: idempotency - page: Retries with backoff path: ./guides/retries-with-backoff.mdx - slug: deep-dives/retries-with-backoff + slug: retries-with-backoff - section: Preview & testing + slug: deep-dives collapsed: true contents: - page: Local SDK previews path: ./guides/setup-local-sdk-previews.mdx - slug: deep-dives/local-previews + slug: local-previews - page: Testing path: ./guides/testing.mdx - slug: deep-dives/testing + slug: testing - section: Hosting + slug: deep-dives collapsed: true contents: - page: Self-hosted SDKs path: ./guides/self-hosted.mdx - slug: deep-dives/self-hosted + slug: self-hosted - section: Reference contents: - page: generators.yml