From 8a01e1fa970d049ce2d429098ccd6f6aa0a6895d Mon Sep 17 00:00:00 2001
From: Devin Logan <devinannlogan@gmail.com>
Date: Fri, 5 Sep 2025 08:52:04 -0400
Subject: [PATCH] document coerce-enums-to-literals and idiomatic-request-names

---
 fern/snippets/openapi-specs.mdx | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/fern/snippets/openapi-specs.mdx b/fern/snippets/openapi-specs.mdx
index e488336e6..7bb11b54b 100644
--- a/fern/snippets/openapi-specs.mdx
+++ b/fern/snippets/openapi-specs.mdx
@@ -37,7 +37,7 @@ api:
   OpenAPI-specific generation settings.
 </ParamField>
 
-<ParamField path="title-as-schema-name" type="boolean" default="true" toc={true}>
+<ParamField path="settings.title-as-schema-name" type="boolean" default="true" toc={true}>
   Whether to use the titles of schemas within an OpenAPI definition as the names of types within Fern.
 </ParamField>
 
@@ -106,3 +106,14 @@ api:
 <ParamField path="example-generation.response.max-depth" type="integer" toc={true}>
   Controls the maximum depth for which optional properties will have examples generated in responses.
 </ParamField>
+
+<ParamField path="coerce-enums-to-literals" type="boolean" default="true" toc={true}>
+  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.
+</ParamField>
+
+<ParamField path="idiomatic-request-names" type="boolean" default="false" toc={true}>
+  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.
+
+  Disabled by default to maintain backwards compatibility.
+
+</ParamField>