From 6a9f40e2bb265a82d22af8ea46cad4b5f3405be3 Mon Sep 17 00:00:00 2001
From: Tony Tam <fehguy@gmail.com>
Date: Tue, 21 Feb 2017 11:37:10 -0800
Subject: [PATCH 1/2] added version clarification

---
 versions/3.0.md | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/versions/3.0.md b/versions/3.0.md
index b271aba2ae..897230f14b 100644
--- a/versions/3.0.md
+++ b/versions/3.0.md
@@ -74,12 +74,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 | 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
 
@@ -221,7 +222,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). 
 

From 58a57ff0371bda9fb433e66adc2d916cf7d4a23e Mon Sep 17 00:00:00 2001
From: Tony Tam <fehguy@gmail.com>
Date: Wed, 22 Feb 2017 09:11:40 -0800
Subject: [PATCH 2/2] clarified FID

---
 versions/3.0.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/versions/3.0.md b/versions/3.0.md
index 897230f14b..df420b256f 100644
--- a/versions/3.0.md
+++ b/versions/3.0.md
@@ -75,7 +75,7 @@ Additional utilities can also take advantage of the resulting files, such as tes
 
 Version | Date | Notes
 ---   | --- | ---
-3.0.0 | 2017-02-28 | Implementor's draft of the 3.0 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.