reorganize auth sections and make more concise

Author: devalog

fern/products/sdks/reference/generators-yml-reference.mdx

@@ -890,13 +890,13 @@ groups:
 The path to the generated snippets file.
 </ParamField>
 
-### API Settings Override
+### Override API Authentication Settings 
 
 Override authentication settings in your API spec using the `api` configuration.
 You can specify authentication schemes, reference existing auth configurations,
 and set additional API-specific settings.
 
-#### String Reference
+#### Single Authentication Scheme
 
 Reference a pre-defined authentication scheme by name.
 
@@ -910,37 +910,13 @@ groups:
           auth: "bearer-token"
 ```
 
-<ParamField path="auth" type="string" required={false} toc={true}>
-The name of an authentication scheme defined in your API specification.
-</ParamField>
-
-#### Scheme Reference
-
-Reference a specific authentication scheme with optional documentation.
-
-```yml {6-9}
-groups: 
-  ts-sdk:
-    generators:
-      - name: fernapi/fern-typescript-sdk
-      ...
-        api:
-          auth:
-            scheme: "my-auth-scheme"
-            docs: "Custom authentication method"
-```
-
-<ParamField path="scheme" type="string" required={true} toc={true}>
-The name of the authentication scheme to use.
-</ParamField>
-
-<ParamField path="docs" type="string" required={false} toc={true}>
-Documentation describing this authentication configuration.
+<ParamField path="auth" type="string | { scheme: string }" required={false} toc={true}>
+The authentication scheme to use. Can be either a string reference (`"bearer-token"`) or scheme object (`scheme: "bearer-token"`).
 </ParamField>
 
 #### Multiple Authentication Options
 
-Allow any of multiple authentication schemes to be used.
+Allow users to authenticate with any of several methods:
 
 ```yml {6-12}
 groups: 
@@ -954,16 +930,12 @@ groups:
               - "api-key"
               - "bearer-token"
               - scheme: "oauth-flow"
-            docs: "Supports multiple authentication methods"
 ```
 
 <ParamField path="any" type="list<string | { scheme: string }>" required={true} toc={true}>
-List of authentication schemes where any one can be used. Can include string references or scheme objects.
+A list of authentication schemes where users can choose any one method. Each item can be either a string reference (`"api-key"`) or scheme object (`scheme: "api-key"`).
 </ParamField>
 
-<ParamField path="docs" type="string" required={false} toc={true}>
-Documentation describing this authentication configuration.
-</ParamField>
 
 #### Custom Authentication Schemes