Skip to content

Commit 8a01e1f

Browse files
committed
document coerce-enums-to-literals and idiomatic-request-names
1 parent bb999b5 commit 8a01e1f

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

fern/snippets/openapi-specs.mdx

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ api:
3737
OpenAPI-specific generation settings.
3838
</ParamField>
3939
40-
<ParamField path="title-as-schema-name" type="boolean" default="true" toc={true}>
40+
<ParamField path="settings.title-as-schema-name" type="boolean" default="true" toc={true}>
4141
Whether to use the titles of schemas within an OpenAPI definition as the names of types within Fern.
4242
</ParamField>
4343
@@ -106,3 +106,14 @@ api:
106106
<ParamField path="example-generation.response.max-depth" type="integer" toc={true}>
107107
Controls the maximum depth for which optional properties will have examples generated in responses.
108108
</ParamField>
109+
110+
<ParamField path="coerce-enums-to-literals" type="boolean" default="true" toc={true}>
111+
Controls whether enums are converted to literal types during code generation. When set to `false`, enums are preserved as enums rather than being converted to literal types. This is useful when you want to maintain the original enum structure from your OpenAPI specification.
112+
</ParamField>
113+
114+
<ParamField path="idiomatic-request-names" type="boolean" default="false" toc={true}>
115+
Controls the naming convention for autogenerated request names. When enabled, places the verb before the noun in request names (e.g., `UsersListRequest` becomes `ListUsersRequest`), following more idiomatic naming patterns.
116+
117+
Disabled by default to maintain backwards compatibility.
118+
119+
</ParamField>

0 commit comments

Comments
 (0)