From 6ba43810a2b379fdcd069fd200dab58ac7210034 Mon Sep 17 00:00:00 2001
From: jongleberry <me@jongleberry.com>
Date: Tue, 22 Mar 2016 10:50:59 -0700
Subject: [PATCH] readme: update docs on released v2

---
 Readme.md | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/Readme.md b/Readme.md
index a137afc..e752326 100644
--- a/Readme.md
+++ b/Readme.md
@@ -20,9 +20,16 @@ $ npm install koa
 
   Koa is supported in node v4+ and node v0.12 with the `--harmony-generators` or `--harmony` flag.
 
-## v2 Alpha
+## Koa v2
 
-  Koa v2 is currently in alpha. In this new version, the middleware function signature completely changes in favor of ES2015-2016 syntax:
+  Koa v2 is currently released with the `next` tag (meaning it will not be marked as latest).
+  You can install it with semver:
+
+```bash
+npm install koa@2
+```
+
+  In this new version, the middleware function signature completely changes in favor of ES2015-2016 syntax:
 
 ```js
 // Koa application is now a class and requires the new operator.
@@ -43,8 +50,10 @@ app.use(async ctx => {
   ctx.body = user; // ctx instead of this
 });
 ```
-  To learn more about Koa v2, follow [this issue](https://github.com/koajs/koa/issues/533).
-  To try Koa v2, `npm install koa@next`.
+
+  Although deprecated, the older, generator-based middleware signature will still work in v2 via [koa-convert](https://github.com/koajs/convert) and will be removed in v3.
+
+  To learn more about Koa v2, follow [this issue](https://github.com/koajs/koa/issues/533) or read the docs here: https://github.com/koajs/koa/tree/v2.x/docs.
 
 ## Community