Skip to content

Commit 1445593

Browse files
authored
Merge pull request #3933 from ralfhandl/3.0.4/formatting-inconsistencies
3.0.4 formatting: don't monospace "Xxx Object"
2 parents 4688b81 + 55d932e commit 1445593

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

versions/3.0.4.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -267,7 +267,7 @@ OpenAPI Description authors SHOULD consider how text using such extensions will
267267
### <a name="relativeReferences"></a>Relative References in URLs
268268

269269
Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [RFC3986](https://tools.ietf.org/html/rfc3986#section-4.2).
270-
Relative references are resolved using the URLs defined in the [`Server Object`](#serverObject) as a Base URI.
270+
Relative references are resolved using the URLs defined in the [Server Object](#serverObject) as a Base URI.
271271

272272
Relative references used in `$ref` are processed as per [JSON Reference](https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03), using the URL of the current document as the base URI. See also the [Reference Object](#referenceObject).
273273

@@ -747,13 +747,13 @@ components:
747747
#### <a name="pathsObject"></a>Paths Object
748748

749749
Holds the relative paths to the individual endpoints and their operations.
750-
The path is appended to the URL from the [`Server Object`](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [ACL constraints](#securityFiltering).
750+
The path is appended to the URL from the [Server Object](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [ACL constraints](#securityFiltering).
751751

752752
##### Patterned Fields
753753

754754
Field Pattern | Type | Description
755755
---|:---:|---
756-
<a name="pathsPath"></a>/{path} | [Path Item Object](#pathItemObject) | A relative path to an individual endpoint. The field name MUST begin with a forward slash (`/`). The path is **appended** (no relative URL resolution) to the expanded URL from the [`Server Object`](#serverObject)'s `url` field in order to construct the full URL. [Path templating](#pathTemplating) is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it's up to the tooling to decide which one to use.
756+
<a name="pathsPath"></a>/{path} | [Path Item Object](#pathItemObject) | A relative path to an individual endpoint. The field name MUST begin with a forward slash (`/`). The path is **appended** (no relative URL resolution) to the expanded URL from the [Server Object](#serverObject)'s `url` field in order to construct the full URL. [Path templating](#pathTemplating) is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it's up to the tooling to decide which one to use.
757757

758758
This object MAY be extended with [Specification Extensions](#specificationExtensions).
759759

@@ -1862,7 +1862,7 @@ However, documentation is expected to cover a successful operation response and
18621862
The `default` MAY be used as a default response object for all HTTP codes
18631863
that are not covered individually by the specification.
18641864

1865-
The `Responses Object` MUST contain at least one response code, and it
1865+
The Responses Object MUST contain at least one response code, and it
18661866
SHOULD be the response for a successful operation call.
18671867

18681868
##### Fixed Fields
@@ -2324,7 +2324,7 @@ In this example, the JSON string had to be serialized before encoding it into th
23242324

23252325
#### <a name="linkObject"></a>Link Object
23262326

2327-
The `Link object` represents a possible design-time link for a response.
2327+
The Link Object represents a possible design-time link for a response.
23282328
The presence of a link does not guarantee the caller's ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.
23292329

23302330
Unlike _dynamic_ links (i.e. links provided **in** the response payload), the OAS linking mechanism does not require link information in the runtime response.

0 commit comments

Comments
 (0)