v1.0

dgeb · dgeb · commit cb49b67cc054 · 2015-05-29T09:16:31.000-04:00
diff --git a/_includes/status.md b/_includes/status.md
@@ -1,5 +1,4 @@
 ## Status <a href="#status" id="status" class="headerlink"></a>
 
-**This document is a work in progress** and is in a final review phase
-before the specification reaches 1.0 on May 28, 2015. See the
-[Status](/status) page for more information.
+**This specification is at version {% include version.md %} and should be
+considered stable.** See the [Status](/status) page for more information.
diff --git a/_includes/version.md b/_includes/version.md
@@ -0,0 +1 @@
+1.0
diff --git a/_layouts/page.html b/_layouts/page.html
@@ -25,14 +25,14 @@
         {% for link in site.navigation %}
           <li {% if url == link.url %}class="active"{% endif %}><a href="{{link.url}}" title="{{link.title}}">{{link.title}}</a></li>
         {% endfor %}
+        <li class="version"><div>v{% include version.md %}</div></li>
       </ul>
     </nav>
     {% if page.show_masthead %}
       <header>
         <div class="content">
           <h1>JSON API</h1>
           <h2>A specification for building APIs in JSON.</h2>
-
           <div class="quicklinks">
             {% for link in site.quicklinks %}
               <a href="{{link.url}}" title="{{link.title}}">{{link.title}}</a>
diff --git a/about/index.md b/about/index.md
@@ -58,8 +58,4 @@ The goals of the media type are to balance:
 * Ease of implementation on the server side
 * Ease of implementation on the client side
 
-This media type is still a work in progress, and we are extremely open to
-feedback and proposals for improvement. That said, implementation work
-has already begun, and we value good working systems over perfect
-vaporware.
-
+This specification reached a stable version 1.0 on May 29, 2015.
diff --git a/faq/index.md b/faq/index.md
@@ -3,11 +3,15 @@ layout: page
 title: Frequently Asked Questions
 ---
 
-## Why is JSON API not versioned? <a href="#why-is-json-api-not-versioned" id="why-is-json-api-not-versioned" class="headerlink"></a>
+## What is the meaning of JSON API's version? <a href="#what-is-the-meaning-of-json-apis-version" id="what-is-the-meaning-of-json-apis-version" class="headerlink"></a>
 
-Once JSON API is stable, it will always be backwards compatible using a _never
-remove, only add_ strategy.
-[#46](https://github.com/json-api/json-api/issues/46)
+Now that JSON API has reached a stable version 1.0, it will always be
+backwards compatible using a _never remove, only add_ strategy.
+
+A version is maintained in order to:
+
+* allow tracking of additive changes to the specification.
+* know what features a particular implementation *may potentially* support.
 
 ## Why not use the HAL specification? <a href="#why-not-use-the-hal-specification" id="why-not-use-the-hal-specification" class="headerlink"></a>
 
diff --git a/index.md b/index.md
@@ -115,7 +115,7 @@ Official extensions are being developed for [Bulk](/extensions/bulk/) and
 
 ## Update history <a href="#update-history" id="update-history" class="headerlink"></a>
 
-- _2015-05-28: 1.0 final to be released._
+- 2015-05-29: 1.0 final released.
 - 2015-05-21: Release candidate 4 released.
 - 2015-03-16: Release candidate 3 released.
 - 2015-02-18: Release candidate 2 released.
diff --git a/status/index.md b/status/index.md
@@ -3,20 +3,15 @@ layout: page
 title: "JSON API: Specification Status"
 ---
 
-JSON API is at a fourth release candidate state.
+**The JSON API specification has reached version 1.0.**
 
-This is the final release candidate before the specification will be tagged
-1.0 on May 28, 2015.
+The [base specification](/format/) should be considered stable. It will
+remain backwards compatible using a _never remove, only add_ strategy.
 
-In the final week before 1.0, do not expect any changes to the specified
-document structure. This release candidate exists solely to provide time for
-the specification to be carefully reviewed for inconsistencies and defects.
+Some work related to this specification, such as [extensions](/extensions/),
+is still experimental and should be considered a work in progress.
 
-Libraries intended to work with 1.0 should implement this version of the
-specification as soon as possible.
-
-Work on this specification is being done at its [GitHub
-repository](https://github.com/json-api/json-api). Please feel free to help
-flesh it out or, if you try to write an implementation, to tell us where things
-were ambiguous. The best way to do so is to [file an
-Issue](https://github.com/json-api/json-api/issues).
+This entire site, including the specification itself, is managed at JSON
+API's [GitHub repository](https://github.com/json-api/json-api). Please feel
+free to suggest changes or let us know if you write an implementation by filing
+an issue or pull request.
diff --git a/stylesheets/all.css b/stylesheets/all.css
diff --git a/stylesheets/all.css.map b/stylesheets/all.css.map
diff --git a/stylesheets/all.sass b/stylesheets/all.sass
@@ -14,7 +14,6 @@ $color-main: rgb(90, 90, 90)
 $color-masthead: rgb(235, 235, 235)
 $border-radius-main: 4px
 
-
 /** Mixins */
 
 @mixin centerbox()
@@ -117,6 +116,13 @@ p > code, li > code
     a
       color: darken($color-main, 80%)
 
+  .version
+    div
+      background-color: lighten($color-main, 10%)
+      color: rgb(255, 255, 255)
+      font-weight: bold
+      padding: 1px 6px
+
 
 /** Header */
 
