From 3545657966a4ad546e29a5f7758bf558b54656e4 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Thu, 24 Jul 2025 09:58:49 -0400 Subject: [PATCH 1/2] add high level overview section to introduction page --- fern/products/sdks/introduction.mdx | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/fern/products/sdks/introduction.mdx b/fern/products/sdks/introduction.mdx index 3d916bca..13381247 100644 --- a/fern/products/sdks/introduction.mdx +++ b/fern/products/sdks/introduction.mdx @@ -1,8 +1,33 @@ --- title: SDKs Overview -description: Generate idiomatic SDKs in multiple programming languages +subtitle: Fern generates and publishes idiomatic SDKs your team can focus on building the API. --- +## How it works + +At a high level, using Fern to build your SDK involves: + +1. **Inputting your API Definition**. Fern takes your API Definition and sets up + a directory (the `fern` folder) containing YAML files that describe your API endpoints, + request/response schemas, authentication, and error handling. +1. **Generating an SDK** in one or multiple languages. Fern SDKs have extensive [built-in + capabilities](/sdks/overview/capabilities) designed to meet your needs. +1. **Adding your custom code and configuration**. Once you have a basic SDK + generated, connect to GitHub, set up publishing credentials, and and + configure other metadata. You can also set up [audience + filtering](/sdks/deep-dives/filter-your-endpoints-audiences), [auto + pagination](/sdks/deep-dives/configure-auto-pagination), and other advanced + capabilities. +1. **Releasing your versioned SDKs** to users via package registries. + +When your API changes, simply update your definition and regenerate the SDK to release a new version. + +## Get started + +First, install the Fern CLI and [set up your `fern` +folder](/sdks/overview/quickstart). Then, generate your SDK. Choose from a wide +range of programming languages, each with its own idiomatic SDK generator: +
{/* Dashed Pattern - Left Side */}
From edbc9bd9061ae5120ed71e52b38c3d413d7cb5b7 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Thu, 24 Jul 2025 10:03:14 -0400 Subject: [PATCH 2/2] update wording --- fern/products/sdks/introduction.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/products/sdks/introduction.mdx b/fern/products/sdks/introduction.mdx index 13381247..b4f000ec 100644 --- a/fern/products/sdks/introduction.mdx +++ b/fern/products/sdks/introduction.mdx @@ -24,8 +24,8 @@ When your API changes, simply update your definition and regenerate the SDK to r ## Get started -First, install the Fern CLI and [set up your `fern` -folder](/sdks/overview/quickstart). Then, generate your SDK. Choose from a wide +After you've installed the Fern CLI and [set up your `fern` +folder](/sdks/overview/quickstart), generate your SDK. Choose from a wide range of programming languages, each with its own idiomatic SDK generator: