Merge pull request #1176 from krishahn/responses-object

edit Responses Object

Author: Ron

versions/3.0.md

@@ -1517,8 +1517,8 @@ requestBody:
 A container for the expected responses of an operation.
 The container maps a HTTP response code to the expected response.
 
-It is not expected for the documentation to necessarily cover all possible HTTP response codes, since they may not be known in advance.
-However, it is expected for the documentation to cover a successful operation response and any known errors.
+The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance.
+However, documentation is expected to cover a successful operation response and any known errors.
 
 The `default` MAY be used as a default response object for all HTTP codes 
 that are not covered individually by the specification.
@@ -1529,7 +1529,7 @@ SHOULD be the response for a successful operation call.
 ##### Fixed Fields
 Field Name | Type | Description
 ---|:---:|---
-<a name="responsesDefault"></a>default | [Response Object](#responseObject) \| [Reference Object](#referenceObject) | The documentation of responses other than the ones declared for specific HTTP response codes. It can be used to cover undeclared responses. [Reference Object](#referenceObject) can be used to link to a response that is defined at the [OpenAPI Object's components/responses](#componentsResponses) section.
+<a name="responsesDefault"></a>default | [Response Object](#responseObject) \| [Reference Object](#referenceObject) | The documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A [Reference Object](#referenceObject) can link to a response that the [OpenAPI Object's components/responses](#componentsResponses) section defines.
 
 ##### Patterned Fields
 Field Pattern | Type | Description