Skip to content

Commit

Permalink
Refresh docs (zircote#1574)
Browse files Browse the repository at this point in the history
  • Loading branch information
DerManoMann authored Apr 18, 2024
1 parent 1cdb866 commit f84583f
Show file tree
Hide file tree
Showing 3 changed files with 182 additions and 124 deletions.
49 changes: 28 additions & 21 deletions docs/reference/annotations.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,7 +155,7 @@ On top of this subset, there are extensions provided by this specification to al

#### Allowed in
---
<a href="#components">Components</a>, <a href="#parameter">Parameter</a>, <a href="#pathparameter">PathParameter</a>, <a href="#mediatype">MediaType</a>, <a href="#jsoncontent">JsonContent</a>, <a href="#xmlcontent">XmlContent</a>
<a href="#components">Components</a>, <a href="#schema">Schema</a>, <a href="#parameter">Parameter</a>, <a href="#pathparameter">PathParameter</a>, <a href="#mediatype">MediaType</a>, <a href="#jsoncontent">JsonContent</a>, <a href="#xmlcontent">XmlContent</a>

#### Nested elements
---
Expand Down Expand Up @@ -490,7 +490,7 @@ The key is the parameter name to be used, whereas the value can be a constant or
be evaluated and passed to the linked operation.<br />
The parameter name can be qualified using the parameter location [{in}.]{name} for operations<br />
that use the same parameter name in different locations (e.g. path.id).</p></dd>
<dt><strong>requestBody</strong> : <span style="font-family: monospace;">mixed</span></dt>
<dt><strong>requestBody</strong></dt>
<dd><p>A literal value or {expression} to use as a request body when calling the target operation.</p></dd>
<dt><strong>description</strong> : <span style="font-family: monospace;">string</span></dt>
<dd><p>A description of the link.<br />
Expand Down Expand Up @@ -519,7 +519,7 @@ Each Media Type object provides schema and examples for the media type identifie
<dl>
<dt><strong>mediaType</strong> : <span style="font-family: monospace;">string</span></dt>
<dd><p>The key into Operation->content array.</p></dd>
<dt><strong>example</strong> : <span style="font-family: monospace;">mixed</span></dt>
<dt><strong>example</strong></dt>
<dd><p>Example of the media type.<br />
<br />
The example object should be in the correct format as specified by the media type.<br />
Expand Down Expand Up @@ -661,7 +661,7 @@ For all other styles, the default value is false.</p></dd>
This property only applies to parameters with an in value of query.<br />
<br />
The default value is false.</p></dd>
<dt><strong>example</strong> : <span style="font-family: monospace;">mixed</span></dt>
<dt><strong>example</strong></dt>
<dd><p>Example of the media type.<br />
<br />
The example should match the specified schema and encoding properties if present.<br />
Expand Down Expand Up @@ -867,7 +867,7 @@ Describes a single request body.
<dt><strong>ref</strong> : <span style="font-family: monospace;">string|class-string|object</span></dt>
<dd><p>The relative or absolute path to a request body.</p><p><i>See</i>: <a href="https://swagger.io/docs/specification/using-ref/">Using refs</a></p></dd>
<dt><strong>request</strong> : <span style="font-family: monospace;">string</span></dt>
<dd><p>Request body model name.</p></dd>
<dd><p>The key into Components->requestBodies array.</p></dd>
<dt><strong>description</strong> : <span style="font-family: monospace;">string</span></dt>
<dd><p>A brief description of the parameter.<br />
<br />
Expand Down Expand Up @@ -932,7 +932,7 @@ On top of this subset, there are extensions provided by this specification to al

#### Nested elements
---
<a href="#discriminator">Discriminator</a>, <a href="#items">Items</a>, <a href="#property">Property</a>, <a href="#externaldocumentation">ExternalDocumentation</a>, <a href="#xml">Xml</a>, <a href="#additionalproperties">AdditionalProperties</a>, <a href="#attachable">Attachable</a>
<a href="#discriminator">Discriminator</a>, <a href="#items">Items</a>, <a href="#property">Property</a>, <a href="#externaldocumentation">ExternalDocumentation</a>, <a href="#examples">Examples</a>, <a href="#xml">Xml</a>, <a href="#additionalproperties">AdditionalProperties</a>, <a href="#attachable">Attachable</a>

#### Properties
---
Expand All @@ -949,10 +949,12 @@ Preferably short; use <code>description</code> for more details.</p></dd>
<dd><p>A description will provide explanation about the purpose of the instance described by this schema.</p></dd>
<dt><strong>maxProperties</strong> : <span style="font-family: monospace;">int</span></dt>
<dd><p>The maximum number of properties allowed in an object instance.<br />
An object instance is valid against this property if its number of properties is less than, or equal to, the value of this attribute.</p></dd>
An object instance is valid against this property if its number of properties is less than, or equal to, the<br />
value of this attribute.</p></dd>
<dt><strong>minProperties</strong> : <span style="font-family: monospace;">int</span></dt>
<dd><p>The minimum number of properties allowed in an object instance.<br />
An object instance is valid against this property if its number of properties is greater than, or equal to, the value of this attribute.</p></dd>
An object instance is valid against this property if its number of properties is greater than, or equal to, the<br />
value of this attribute.</p></dd>
<dt><strong>required</strong> : <span style="font-family: monospace;">string[]</span></dt>
<dd><p>An object instance is valid against this property if its property set contains all elements in this property's<br />
array value.</p></dd>
Expand All @@ -972,10 +974,10 @@ Possible values are:<br />
- ssv: space separated values foo bar.<br />
- tsv: tab separated values foo\tbar.<br />
- pipes: pipe separated values foo|bar.<br />
- multi: corresponds to multiple parameter instances instead of multiple values for a single instance foo=bar&foo=baz.<br />
This is valid only for parameters of type <code>query</code> or <code>formData</code>.<br />
Default value is csv.</p></dd>
<dt><strong>default</strong> : <span style="font-family: monospace;">mixed</span></dt>
- multi: corresponds to multiple parameter instances instead of multiple values for a single instance<br />
foo=bar&foo=baz. This is valid only for parameters of type <code>query</code> or <code>formData</code>. Default<br />
value is csv.</p></dd>
<dt><strong>default</strong></dt>
<dd><p>Sets a default value to the parameter. The type of the value depends on the defined type.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor101">JSON schema validation</a></p></dd>
<dt><strong>maximum</strong> : <span style="font-family: monospace;">int|float</span></dt>
<dd><p>The maximum value allowed for a numeric property. This value must be a number.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor17">JSON schema validation</a></p></dd>
Expand All @@ -992,29 +994,34 @@ When set to true, the minimum value is excluded, and when false or not specified
<dt><strong>maxLength</strong> : <span style="font-family: monospace;">int</span></dt>
<dd><p>The maximum length of a string property.<br />
<br />
A string instance is valid against this property if its length is less than, or equal to, the value of this attribute.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor26">JSON schema validation</a></p></dd>
A string instance is valid against this property if its length is less than, or equal to, the value of this<br />
attribute.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor26">JSON schema validation</a></p></dd>
<dt><strong>minLength</strong> : <span style="font-family: monospace;">int</span></dt>
<dd><p>The minimum length of a string property.<br />
<br />
A string instance is valid against this property if its length is greater than, or equal to, the value of this attribute.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor29">JSON schema validation</a></p></dd>
A string instance is valid against this property if its length is greater than, or equal to, the value of this<br />
attribute.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor29">JSON schema validation</a></p></dd>
<dt><strong>pattern</strong> : <span style="font-family: monospace;">string</span></dt>
<dd><p>A string instance is considered valid if the regular expression matches the instance successfully.</p></dd>
<dt><strong>maxItems</strong> : <span style="font-family: monospace;">int</span></dt>
<dd><p>The maximum number of items allowed in an array property.<br />
<br />
An array instance is valid against this property if its number of items is less than, or equal to, the value of this attribute.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor42">JSON schema validation</a></p></dd>
An array instance is valid against this property if its number of items is less than, or equal to, the value of<br />
this attribute.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor42">JSON schema validation</a></p></dd>
<dt><strong>minItems</strong> : <span style="font-family: monospace;">int</span></dt>
<dd><p>The minimum number of items allowed in an array property.<br />
<br />
An array instance is valid against this property if its number of items is greater than, or equal to, the value of this attribute.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor45">JSON schema validation</a></p></dd>
An array instance is valid against this property if its number of items is greater than, or equal to, the value<br />
of this attribute.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor45">JSON schema validation</a></p></dd>
<dt><strong>uniqueItems</strong> : <span style="font-family: monospace;">bool</span></dt>
<dd><p>A boolean value indicating whether all items in an array property must be unique.<br />
<br />
If this attribute is set to true, then all items in the array must be unique.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor49">JSON schema validation</a></p></dd>
<dt><strong>enum</strong> : <span style="font-family: monospace;">string[]|int[]|float[]|bool[]|\UnitEnum[]|class-string</span></dt>
<dt><strong>enum</strong> : <span style="font-family: monospace;">array&lt;string|int|float|bool|\UnitEnum&gt;|class-string</span></dt>
<dd><p>A collection of allowable values for a property.<br />
<br />
A property instance is valid against this attribute if its value is one of the values specified in this collection.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor76">JSON schema validation</a></p></dd>
A property instance is valid against this attribute if its value is one of the values specified in this<br />
collection.</p><p><i>See</i>: <a href="http://json-schema.org/latest/json-schema-validation.html#anchor76">JSON schema validation</a></p></dd>
<dt><strong>multipleOf</strong> : <span style="font-family: monospace;">int|float</span></dt>
<dd><p>A numeric instance is valid against "multipleOf" if the result of the division of the instance by this<br />
property's value is an integer.</p></dd>
Expand All @@ -1035,7 +1042,7 @@ Therefore, it may be sent as part of a request but should not be sent as part of
If the property is marked as writeOnly being true and is in the required list, the required will take effect on<br />
the request only. A property must not be marked as both readOnly and writeOnly being true. Default value is<br />
false.</p></dd>
<dt><strong>example</strong> : <span style="font-family: monospace;">mixed</span></dt>
<dt><strong>example</strong></dt>
<dd><p>A free-form property to include an example of an instance for this schema.<br />
<br />
To represent examples that cannot naturally be represented in JSON or YAML, a string value can be used to<br />
Expand Down Expand Up @@ -1070,7 +1077,7 @@ defined by this property's value.</p></dd>
<dd><p>http://json-schema.org/latest/json-schema-validation.html#rfc.section.6.21.</p></dd>
<dt><strong>propertyNames</strong></dt>
<dd><p>http://json-schema.org/latest/json-schema-validation.html#rfc.section.6.22.</p></dd>
<dt><strong>const</strong> : <span style="font-family: monospace;">mixed</span></dt>
<dt><strong>const</strong></dt>
<dd><p>http://json-schema.org/draft/2020-12/json-schema-validation.html#rfc.section.6.1.3.</p></dd>
</dl>

Expand Down Expand Up @@ -1168,7 +1175,7 @@ An object representing a server variable for server URL template substitution.
<dl>
<dt><strong>serverVariable</strong> : <span style="font-family: monospace;">string</span></dt>
<dd><p>The key into Server->variables array.</p></dd>
<dt><strong>enum</strong> : <span style="font-family: monospace;">string[]|int[]|float[]|bool[]|\UnitEnum[]|class-string</span></dt>
<dt><strong>enum</strong> : <span style="font-family: monospace;">array&lt;string|int|float|bool|\UnitEnum&gt;|class-string</span></dt>
<dd><p>An enumeration of values to be used if the substitution options are from a limited set.</p></dd>
<dt><strong>default</strong> : <span style="font-family: monospace;">string</span></dt>
<dd><p>The default value to use for substitution, and to send, if an alternate value is not supplied.<br />
Expand Down
Loading

0 comments on commit f84583f

Please sign in to comment.