Issue #577: put the interfaces object into the components object from #633.

Also, rename it to "Interfaces Definitions Object".

Author: Paŭlo Ebermann

versions/3.0.md

@@ -269,6 +269,7 @@ Field Pattern | Type | Description
 <a name="parametersDefinitionsObject"></a> | [Parameters Definitions Object](#parametersDefinitionsObject) | An object to hold parameters to be reused across operations. Parameter definitions can be referenced to the ones defined here.
 <a name="responseHeadersDefinitionsObject"></a> | [Response Headers Definitions Object](#responseHeadersDefinitionsObject) | Response headers to reuse across the specification.
 <a name="securityDefinitionsObject"></a> | [Security Definitions Object](#securityDefinitionsObject) | Security definitions to reuse across the specification.
+<a name="componentsInterfaces"></a> interfaces | [Interface Definitions Object](#interfacesDefinitionsObject) | Interface definitions to reuse in paths or URI properties in schemas.
 
 
 #### <a name="pathsObject"></a>Paths Object
@@ -436,7 +437,7 @@ This example refers to the pet-list example in the [Interface object](#interface
 
 ```js
 {
-  "$ref": "#/interfaces/pet-list", 
+  "$ref": "#/components/interfaces/pet-list", 
   "parameters": [
     {
       "name": "id",
@@ -454,7 +455,7 @@ This example refers to the pet-list example in the [Interface object](#interface
 ```
 
 ```yaml
-$ref: '#/interfaces/pet-list'
+$ref: '#/components/interfaces/pet-list'
 parameters:
 - name: id
   in: path
@@ -466,9 +467,9 @@ parameters:
   collectionFormat: csv
 ```
 
-#### <a name="interfacesObject"></a> Interfaces Object
+#### <a name="interfacesDefinitionsObject"></a> Interfaces Definitions Object
 
-The Interfaces objects defines named interfaces which can then be implemented by [path items](#pathItemObject) declared in the [Paths object](#pathsObject) or by URI properties in schemas.
+The Interfaces definitions object defines named interfaces which can then be implemented by [path items](#pathItemObject) declared in the [Paths object](#pathsObject) or by URI properties in schemas.
 
 ##### Patterned Fields