(to rebase)

but I want to reword that a little

Co-authored-by: Ralf Handl <[email protected]>

Author: rvedotrc

versions/3.1.1.md

@@ -979,7 +979,7 @@ Describes a single API operation on a path.
 | <a name="operation-responses"></a>responses       |                           [Responses Object](#responses-object)                            | The list of possible responses as they are returned from executing this operation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | <a name="operation-callbacks"></a>callbacks       | Map[`string`, [Callback Object](#callback-object) \| [Reference Object](#reference-object)] | A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a [Callback Object](#callback-object) that describes a request that may be initiated by the API provider and the expected responses.                                                                                                                                                                                                                                                                                                             |
 | <a name="operation-deprecated"></a>deprecated     |                                         `boolean`                                         | Declares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| <a name="operation-security"></a>security         |                [[Security Requirement Object](#security-requirement-object)]                | If present, then this overrides any [top-level `security` field](#oas-security) for this operation. See the definition of that field for details.
+| <a name="operation-security"></a>security         |                [[Security Requirement Object](#security-requirement-object)]                | A declaration of which security mechanisms can be used for this operation. If present, then this overrides any [top-level `security` field](#oas-security) for this operation. See the [definition of that field](#the-security-field) for details.
 | <a name="operation-servers"></a>servers           |                             [[Server Object](#server-object)]                              | An alternative `server` array to service this operation. If an alternative `server` object is specified at the Path Item Object or Root level, it will be overridden by this value.                                                                                                                                                                                                                                                                                                                                                                                                                       |
 
 This object MAY be extended with [Specification Extensions](#specification-extensions).