Skip to content

Commit 79368ce

Browse files
committed
update wording around extensions
1 parent c68c6f7 commit 79368ce

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

fern/products/api-def/pages/overrides.mdx

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,15 @@ title: Overrides
33
description: Customize your API definition using a separate overrides file.
44
---
55

6-
Use an overrides file to customize your API definition without modifying the original spec. This is useful when:
6+
Use an overrides file to customize your OpenAPI, AsyncAPI, OpenRPC, or gRPC definition without modifying the original spec. This is useful when:
77

88
* Your API specification is auto-generated from server code
99
* You need different configurations for SDKs versus documentation
1010

11+
Overrides are available for OpenAPI, AsyncAPI, OpenRPC, and gRPC specifications. They are not needed for [Fern Definition](/api-definitions/ferndef/overview) since you can directly edit those files.
12+
1113
<Note>
12-
While you can also embed [Fern extensions](https://buildwithfern.com/learn/api-definitions/openapi/extensions/overview) directly in your API specification, using overrides files is the recommended approach as it keeps your original spec clean and separates concerns.
14+
While you can also embed [Fern extensions](/api-definitions/overview/overrides#definition-specific-extensions) directly in your API specification, using overrides files is the recommended approach as it keeps your original spec clean and separates concerns.
1315
</Note>
1416

1517
## Implement overrides
@@ -32,6 +34,9 @@ fern/
3234

3335
</Step>
3436
<Step title="Customize your spec with Fern extensions">
37+
38+
For OpenAPI, AsyncAPI, and OpenRPC, and gRPC, you can use [Fern's extensions](/api-definitions/overview/overrides#definition-specific-extensions) to apply customizations.
39+
3540
```yml title="overrides.yml" {4-5}
3641
paths:
3742
/users:
@@ -158,9 +163,9 @@ groups:
158163
version: 0.8.8
159164
```
160165

161-
## Definition-specific customizations
166+
## Definition-specific extensions
162167

163-
Learn more about the customizations you can make for each definition:
168+
Learn more about the Fern extensions you can use to customize your definition:
164169

165170
<CardGroup cols={2}>
166171
<Card title="OpenAPI" href="/api-definitions/openapi/extensions/overview">

0 commit comments

Comments
 (0)