Docs tweaks

docs/index.md

@@ -104,7 +104,7 @@ General guides to using REST framework.
 * [REST, Hypermedia & HATEOAS][rest-hypermedia-hateoas]
 * [Contributing to REST framework][contributing]
 * [2.0 Migration Guide][migration]
-* [Change Log][changelog]
+* [Release Notes][release-notes]
 * [Credits][credits]
 
 ## Development
@@ -190,7 +190,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 [rest-hypermedia-hateoas]: topics/rest-hypermedia-hateoas.md
 [contributing]: topics/contributing.md
 [migration]: topics/migration.md
-[changelog]: topics/changelog.md
+[release-notes]: topics/release-notes.md
 [credits]: topics/credits.md
 
 [group]: https://groups.google.com/forum/?fromgroups#!forum/django-rest-framework

docs/template.html

@@ -78,7 +78,7 @@
                   <li><a href="{{ base_url }}/topics/rest-hypermedia-hateoas{{ suffix }}">REST, Hypermedia & HATEOAS</a></li>
                   <li><a href="{{ base_url }}/topics/contributing{{ suffix }}">Contributing to REST framework</a></li>
                   <li><a href="{{ base_url }}/topics/migration{{ suffix }}">2.0 Migration Guide</a></li>
-                  <li><a href="{{ base_url }}/topics/changelog{{ suffix }}">Change Log</a></li>
+                  <li><a href="{{ base_url }}/topics/release-notes{{ suffix }}">Release Notes</a></li>
                   <li><a href="{{ base_url }}/topics/credits{{ suffix }}">Credits</a></li>
                 </ul>
               </li>

docs/topics/changelog.md → docs/topics/release-notes.md

-# Change Log
+# Release Notes
+
+> Release Early, Release Often
+>
+> — Eric S. Raymond, [The Cathedral and the Bazaar][cite].
 
 ## 2.0.0
 
-* **Fix all of the things.**
+* **Fix all of the things.**  (Well, almost.)
 * For more information please see the [2.0 migration guide][migration].
 
 ---
@@ -108,4 +112,5 @@
 
 * Initial release.
 
+[cite]: http://www.catb.org/~esr/writings/cathedral-bazaar/cathedral-bazaar/ar01s04.html
 [migration]: migration.md
\ No newline at end of file

docs/topics/rest-hypermedia-hateoas.md

@@ -24,13 +24,13 @@ For a more thorough background, check out Klabnik's [Hypermedia API reading list
 
 REST framework is an agnositic Web API toolkit.  It does help guide you towards building well-connected APIs, and makes it easy to design appropriate media types, but it does not strictly enforce any particular design style.
 
-## What REST framework *does* provide.
+## What REST framework provides.
 
 It is self evident that REST framework makes it possible to build Hypermedia APIs.  The browseable API that it offers is built on HTML - the hypermedia language of the web.
 
 REST framework also includes [serialization] and [parser]/[renderer] components that make it easy to build appropriate media types, [hyperlinked relations][fields] for building well-connected systems, and great support for [content negotiation][conneg].
 
-## What REST framework *doesn't* provide.
+## What REST framework doesn't provide.
 
 What REST framework doesn't do is give you is machine readable hypermedia formats such as [Collection+JSON][collection] or HTML [microformats] by default, or the ability to auto-magically create fully HATEOAS style APIs that include hypermedia-based form descriptions and semantically labelled hyperlinks.  Doing so would involve making opinionated choices about API design that should really remain outside of the framework's scope.