Merge pull request #901 from OAI/issue-589-version-clarification

added version clarification

Author: fehguy

versions/3.0.md

@@ -73,12 +73,13 @@ Additional utilities can also take advantage of the resulting files, such as tes
 ## Revision History
 
 Version | Date | Notes
---- | --- | ---
-2.0 | 2015-12-31 | Donation of Swagger 2.0 to the Open API Initiative
-2.0 | 2014-09-08 | Release of Swagger 2.0
-1.2 | 2014-03-14 | Initial release of the formal document.
-1.1 | 2012-08-22 | Release of Swagger 1.1
-1.0 | 2011-08-10 | First release of the Swagger Specification
+---   | --- | ---
+3.0.0-rc0 | 2017-02-28 | Implementor's draft of the 3.0 specification
+2.0   | 2015-12-31 | Donation of Swagger 2.0 to the Open API Initiative
+2.0   | 2014-09-08 | Release of Swagger 2.0
+1.2   | 2014-03-14 | Initial release of the formal document.
+1.1   | 2012-08-22 | Release of Swagger 1.1
+1.0   | 2011-08-10 | First release of the Swagger Specification
 
 ## Definitions
 
@@ -220,7 +221,7 @@ Field Name | Type | Description
 <a name="infoTermsOfService"></a>termsOfService | `string` | A URL to the Terms of Service for the API.
 <a name="infoContact"></a>contact | [Contact Object](#contactObject) | The contact information for the exposed API.
 <a name="infoLicense"></a>license | [License Object](#licenseObject) | The license information for the exposed API.
-<a name="infoVersion"></a>version | `string` | **Required** Provides the version of the application API (not to be confused with the specification version).
+<a name="infoVersion"></a>version | `string` | **Required** Provides the version of the application API (not to be confused with the specification version).  While not required, is it suggested that the `info.version` value correspond to the version of the API definition.  In practice, the version of the API _implementation_ may evolve at an entirely different rate.
 
 This object can be extended with [Specification Extensions](#specificationExtensions).