Skip to content

Commit b6e5791

Browse files
committed
Tweak grammar and diction
1 parent 8712108 commit b6e5791

File tree

1 file changed

+4
-5
lines changed

1 file changed

+4
-5
lines changed

versions/3.0.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -119,12 +119,11 @@ For example, if a field is said to have an array value, the JSON array represent
119119
}
120120
```
121121

122-
While the API is described using JSON it does not impose a JSON input/output to the API itself.
122+
Even though the API is described with JSON, it is not required to use JSON for input or output.
123123

124124
All field names in the specification are **case sensitive**.
125125

126-
The schema exposes two types of fields.
127-
Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.
126+
The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.
128127
Patterned fields can have multiple occurrences as long as each has a unique name.
129128

130129
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:
@@ -1136,8 +1135,8 @@ items:
11361135

11371136
A container for the expected responses of an operation.
11381137
The container maps a HTTP response code to the expected response.
1139-
It is not expected from the documentation to necessarily cover all possible HTTP response codes, since they may not be known in advance.
1140-
However, it is expected from the documentation to cover a successful operation response and any known errors.
1138+
It is not expected for the documentation to necessarily cover all possible HTTP response codes, since they may not be known in advance.
1139+
However, it is expected for the documentation to cover a successful operation response and any known errors.
11411140

11421141
The `default` MAY be used as a default response object for all HTTP codes that are not covered individually by the specification.
11431142

0 commit comments

Comments
 (0)