Remove anything deemed controversial

Author: jdesrosiers

versions/3.1.1.md

@@ -2702,10 +2702,6 @@ schema at `#/components/schemas/Cat` is "Cat". Therefore, when using
 `discriminator`, _inline_ schemas will not be considered because they don't have
 a "name".
 
-Schema names are scoped to the OpenAPI document they are defined in. That means
-if OpenAPI document "A" references a schema in OpenAPI document "B", the schema
-names in "A" aren't considered when evaluating the referenced schema in "B".
-
 ##### Fixed Fields
 Field Name | Type | Description
 ---|:---:|---
@@ -2776,11 +2772,6 @@ For example:
 ```yaml
 components:
   schemas:
-    MyResponseType:
-      oneOf:
-      - $ref: '#/components/schemas/Cat'
-      - $ref: '#/components/schemas/Dog'
-      - $ref: '#/components/schemas/Lizard'
     Pet:
       type: object
       required:
@@ -2818,12 +2809,7 @@ components:
             type: boolean
 ```
 
-The `MyResponseType` schema will use the discriminator defined by the `Pet`
-schema because it is part of the `Cat`, `Dog`, and `Lizard` schemas in the
-`oneOf`. The behavior if not all schemas define a `discriminator` and they are
-not all the same is undefined.
-
-Validated against the `MyResponseType` schema, a payload like this:
+Validated against the `Pet` schema, a payload like this:
 
 ```json
 {