Skip to content

Commit 91761e5

Browse files
authored
[Format] Suggested edits from Liz Lynch
* Replace "a OAS" with "an OAS" * Remove extra text from array description * Hyperlink to YAML Failsafe schema ruleset Signed-off-by: Rob Dolin <[email protected]>
1 parent a6fd0df commit 91761e5

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

versions/3.0.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -109,10 +109,10 @@ The HTTP Status Codes are used to indicate the status of the executed operation.
109109

110110
### Format
111111

112-
The files describing the RESTful API in accordance with the OpenAPI Specification are represented as JSON objects and conform to the JSON standards.
113-
YAML, being a superset of JSON, can be used as well to represent a OAS (OpenAPI Specification) file.
112+
The files describing the RESTful API in accordance with this specification are represented as JSON objects and conform to the JSON standards.
113+
YAML, being a superset of JSON, can be used as well to represent an OAS file.
114114

115-
For example, if a field is said to have an array value, the JSON array representation will be used:
115+
For example, if a field has an array value, the JSON array representation will be used:
116116

117117
```json
118118
{
@@ -131,7 +131,7 @@ Patterned fields can have multiple occurrences as long as each has a unique name
131131
In order to preserve the ability to round-trip between YAML and JSON formats, YAML version [1.2](http://www.yaml.org/spec/1.2/spec.html) is recommended along with some additional constraints:
132132

133133
- Tags MUST be limited to those allowed by the [JSON Schema ruleset](http://www.yaml.org/spec/1.2/spec.html#id2803231)
134-
- Keys used in YAML maps MUST be limited to a scalar string, as defined by the YAML Failsafe schema ruleset
134+
- Keys used in YAML maps MUST be limited to a scalar string, as defined by the [YAML Failsafe schema ruleset](http://yaml.org/spec/1.2/spec.html#id2802346)
135135

136136
### File Structure
137137

0 commit comments

Comments
 (0)