@@ -67,23 +67,21 @@ pub struct PathItem {
67
67
pub trace : Option < Operation > ,
68
68
69
69
/// An alternative `server` array to service all operations in this path.
70
- #[ serde( default ) ]
71
- #[ serde( skip_serializing_if = "Vec::is_empty" ) ]
70
+ #[ serde( default , skip_serializing_if = "Vec::is_empty" ) ]
72
71
pub servers : Vec < Server > ,
73
72
74
- /// A list of parameters that are applicable for all the operations described under this
75
- /// path. These parameters can be overridden at the operation level, but cannot be removed
76
- /// there. The list MUST NOT include duplicated parameters. A unique parameter is defined by
77
- /// a combination of a
78
- /// [name](https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md#parameterName)
79
- /// and
80
- /// [location](https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md#parameterIn).
81
- /// The list can use the
82
- /// [Reference Object](https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md#reference-object)
83
- /// to link to parameters that are defined at the
84
- /// [OpenAPI Object's components/parameters](https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md#componentsParameters).
85
- #[ serde( default ) ]
86
- #[ serde( skip_serializing_if = "Vec::is_empty" ) ]
73
+ /// A list of parameters that are applicable for all the operations described under this path.
74
+ ///
75
+ /// These parameters can be overridden at the operation level, but cannot be removed there. The
76
+ /// list MUST NOT include duplicated parameters. A unique parameter is defined by a combination
77
+ /// of a [name] and [location] The list can use the [Reference Object] to link to parameters
78
+ /// that are defined at the [OpenAPI Object's components/parameters].
79
+ ///
80
+ /// [name]: https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md#parameterName
81
+ /// [location]: https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md#parameterIn
82
+ /// [Reference Object]: https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md#reference-object
83
+ /// [OpenAPI Object's components/parameters]: https://github.com/OAI/OpenAPI-Specification/blob/HEAD/versions/3.1.0.md#componentsParameters
84
+ #[ serde( default , skip_serializing_if = "Vec::is_empty" ) ]
87
85
pub parameters : Vec < ObjectOrReference < Parameter > > ,
88
86
89
87
/// Specification extensions.
0 commit comments