move location of parameters: [null] info

Author: devalog

fern/products/api-def/openapi-pages/extensions/ignore.mdx

@@ -1,9 +1,11 @@
 ---
 title: Ignoring elements
-description: Skip reading endpoints, schemas, or properties using the `x-fern-ignore` extension
+description: Skip reading endpoints, schemas, properties, or parameters using the `x-fern-ignore` extension
 ---
 
-If you want Fern to skip reading any endpoints, schemas, or properties, use the `x-fern-ignore` extension.
+If you want Fern to skip reading any endpoints, schemas, properties, or parameters, use the `x-fern-ignore` extension.
+
+## Ignore an endpoint
 
 To skip an endpoint, add `x-fern-ignore: true` at the operation level.
 
@@ -14,6 +16,7 @@ paths:
       x-fern-ignore: true
       ...
 ```
+## Ignore a schema
 
 To skip a schema, add `x-fern-ignore: true` at the schema level.
 
@@ -25,6 +28,7 @@ components:
       ...
 ```
 
+## Ignore a property
 To skip a property within a schema, add `x-fern-ignore: true` at the property level.
 
 ```yaml title="x-fern-ignore at property level in openapi.yml" {9}
@@ -39,3 +43,30 @@ components:
           x-fern-ignore: true
           type: string
 ```
+
+## Ignore a parameter
+
+To skip a parameter, add `x-fern-ignore: true` at the parameter level.
+```yaml title="x-fern-ignore at parameter level in openapi.yml" {7}
+paths:
+  /users:
+    get:
+      parameters:
+        - name: internalParam
+          in: query
+          x-fern-ignore: true
+          schema:
+            type: string
+```
+
+<Tip>
+To skip a parameter without modifying your base spec, use `null` values in your [overrides file](/api-definitions/overview/overrides) to delete parameters:
+
+```yaml title="overrides.yml" {5}
+paths:
+  "/users":
+    get:
+      parameters:
+        - null  # Deletes the first parameter from base spec
+```
+</Tip>

fern/products/api-def/openapi-pages/extensions/parameter-names.mdx

@@ -63,86 +63,3 @@ paths:
             type: string
           required: false
 ```
-
-## Delete parameters with null overrides
-
-You can use explicit `null` values in your overrides file to delete parameters from the base specification. This is useful when:
-
-- Resolving duplicate identifier conflicts between query parameters and request body properties
-- Removing deprecated or unnecessary parameters from the SDK
-- Simplifying the SDK interface by hiding internal parameters
-
-<Warning>
-Deleting parameters is a breaking change. Parameters removed via null overrides will not be available in the generated SDK, even though they exist in the base OpenAPI specification.
-</Warning>
-
-### Delete a single parameter
-
-To delete the first parameter from an endpoint, use `parameters: [null]` in your overrides file:
-
-```yaml title="overrides.yml" {5-6}
-paths:
-  "/edge-config":
-    post:
-      x-fern-sdk-group-name: edgeConfig
-      x-fern-sdk-method-name: create
-      parameters:
-        - null
-```
-
-This removes the first parameter defined in the base specification for this endpoint.
-
-### Delete multiple parameters
-
-To delete multiple parameters, add multiple `null` entries:
-
-```yaml title="overrides.yml" {5-8}
-paths:
-  "/users":
-    get:
-      x-fern-sdk-group-name: users
-      x-fern-sdk-method-name: list
-      parameters:
-        - null  # Deletes first parameter
-        - null  # Deletes second parameter
-```
-
-### Real-world example: Resolving duplicate identifiers
-
-A common use case is resolving duplicate identifier errors when a query parameter and request body property have the same name. In this example, both the query parameter `slug` and the request body property `slug` would cause a TypeScript compilation error:
-
-<CodeGroup>
-```yaml title="openapi.yml"
-paths:
-  "/edge-config":
-    post:
-      operationId: create_edge_config
-      parameters:
-        - name: slug
-          in: query
-          description: "The Team slug"
-          schema:
-            type: string
-      requestBody:
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                slug:
-                  type: string
-                  description: "The Edge Config slug"
-```
-
-```yaml title="overrides.yml"
-paths:
-  "/edge-config":
-    post:
-      x-fern-sdk-group-name: edgeConfig
-      x-fern-sdk-method-name: create
-      parameters:
-        - null  # Removes the query parameter slug
-```
-</CodeGroup>
-
-After applying the override, the generated SDK will only include the request body `slug` property, eliminating the duplicate identifier error.