diff --git a/docs/api/request.md b/docs/api/request.md
index 3a281a8..4502085 100644
--- a/docs/api/request.md
+++ b/docs/api/request.md
@@ -6,74 +6,74 @@
 
 ## API
 
-### req.header
+### request.header
 
  Request header object.
 
-### req.headers
+### request.headers
 
- Request header object. Alias as `req.header`.
+ Request header object. Alias as `request.header`.
 
-### req.method
+### request.method
 
   Request method.
 
-### req.method=
+### request.method=
 
   Set request method, useful for implementing middleware
   such as `methodOverride()`.
 
-### req.length
+### request.length
 
   Return request Content-Length as a number when present, or `undefined`.
 
-### req.url
+### request.url
 
   Get request URL.
 
-### req.url=
+### request.url=
 
   Set request URL, useful for url rewrites.
 
-### req.originalUrl
+### request.originalUrl
 
   Get request original URL.
 
-### req.path
+### request.path
 
   Get request pathname.
 
-### req.path=
+### request.path=
 
   Set request pathname and retain query-string when present.
 
-### req.querystring
+### request.querystring
 
   Get raw query string void of `?`.
 
-### req.querystring=
+### request.querystring=
 
   Set raw query string.
 
-### req.search
+### request.search
 
   Get raw query string with the `?`.
 
-### req.search=
+### request.search=
 
   Set raw query string.
 
-### req.host
+### request.host
 
   Get host (hostname:port) when present. Supports `X-Forwarded-Host`
   when `app.proxy` is __true__, otherwise `Host` is used.
 
-### req.hostname
+### request.hostname
 
   Get hostname when present. Supports `X-Forwarded-Host`
   when `app.proxy` is __true__, otherwise `Host` is used.
 
-### req.type
+### request.type
 
   Get request `Content-Type` void of parameters such as "charset".
 
@@ -82,7 +82,7 @@ var ct = this.request.type;
 // => "image/png"
 ```
 
-### req.charset
+### request.charset
 
   Get request charset when present, or `undefined`:
 
@@ -91,7 +91,7 @@ this.request.charset
 // => "utf-8"
 ```
 
-### req.query
+### request.query
 
   Get parsed query-string, returning an empty object when no
   query-string is present. Note that this getter does _not_
@@ -106,7 +106,7 @@ this.request.charset
 }
 ```
 
-### req.query=
+### request.query=
 
   Set query-string to the given object. Note that this
   setter does _not_ support nested objects.
@@ -115,7 +115,7 @@ this.request.charset
 this.query = { next: '/login' };
 ```
 
-### req.fresh
+### request.fresh
 
   Check if a request cache is "fresh", aka the contents have not changed. This
   method is for cache negotiation between `If-None-Match` / `ETag`, and `If-Modified-Since` and `Last-Modified`. It should be referenced after setting one or more of these response headers.
@@ -134,32 +134,32 @@ if (this.fresh) {
 this.body = yield db.find('something');
 ```
 
-### req.stale
+### request.stale
 
-  Inverse of `req.fresh`.
+  Inverse of `request.fresh`.
 
-### req.protocol
+### request.protocol
 
   Return request protocol, "https" or "http". Supports `X-Forwarded-Proto`
   when `app.proxy` is __true__.
 
-### req.secure
+### request.secure
 
   Shorthand for `this.protocol == "https"` to check if a request was
   issued via TLS.
 
-### req.ip
+### request.ip
 
   Request remote address. Supports `X-Forwarded-For` when `app.proxy`
   is __true__.
 
-### req.ips
+### request.ips
 
   When `X-Forwarded-For` is present and `app.proxy` is enabled an array
   of these ips is returned, ordered from upstream -> downstream. When disabled
   an empty array is returned.
 
-### req.subdomains
+### request.subdomains
 
   Return subdomains as an array.
 
@@ -171,7 +171,7 @@ this.body = yield db.find('something');
   If `app.subdomainOffset` is not set, this.subdomains is `["ferrets", "tobi"]`.
   If `app.subdomainOffset` is 3, this.subdomains is `["tobi"]`.
 
-### req.is(types...)
+### request.is(types...)
 
   Check if the incoming request contains the "Content-Type"
   header field, and it contains any of the give mime `type`s.
@@ -208,10 +208,10 @@ if (this.is('image/*')) {
 
   Koa's `request` object includes helpful content negotiation utilities powered by [accepts](http://github.com/expressjs/accepts) and [negotiator](https://github.com/federomero/negotiator). These utilities are:
 
-- `req.accepts(types)`
-- `req.acceptsEncodings(types)`
-- `req.acceptsCharsets(charsets)`
-- `req.acceptsLanguages(langs)`
+- `request.accepts(types)`
+- `request.acceptsEncodings(types)`
+- `request.acceptsCharsets(charsets)`
+- `request.acceptsLanguages(langs)`
 
   If no types are supplied, __all__ acceptable types are returned.
 
@@ -219,7 +219,7 @@ if (this.is('image/*')) {
 
   In the case of missing accept headers where any type is acceptable, the first type will be returned. Thus, the order of types you supply is important.
 
-### req.accepts(types)
+### request.accepts(types)
 
   Check if the given `type(s)` is acceptable, returning the best match when true, otherwise `false`. The `type` value may be one or more mime type string
   such as "application/json", the extension name
@@ -269,7 +269,7 @@ switch (this.accepts('json', 'html', 'text')) {
 }
 ```
 
-### req.acceptsEncodings(encodings)
+### request.acceptsEncodings(encodings)
 
   Check if `encodings` are acceptable, returning the best match when true, otherwise `false`. Note that you should include `identity` as one of the encodings!
 
@@ -293,7 +293,7 @@ this.acceptsEncodings();
 
   Note that the `identity` encoding (which means no encoding) could be unacceptable if the client explicitly sends `identity;q=0`. Although this is an edge case, you should still handle the case where this method returns `false`.
 
-### req.acceptsCharsets(charsets)
+### request.acceptsCharsets(charsets)
 
   Check if `charsets` are acceptable, returning
   the best match when true, otherwise `false`.
@@ -316,7 +316,7 @@ this.acceptsCharsets();
 // => ["utf-8", "utf-7", "iso-8859-1"]
 ```
 
-### req.acceptsLanguages(langs)
+### request.acceptsLanguages(langs)
 
   Check if `langs` are acceptable, returning
   the best match when true, otherwise `false`.
@@ -339,14 +339,14 @@ this.acceptsLanguages();
 // => ["es", "pt", "en"]
 ```
 
-### req.idempotent
+### request.idempotent
 
   Check if the request is idempotent.
 
-### req.socket
+### request.socket
 
   Return the request socket.
 
-### req.get(field)
+### request.get(field)
 
   Return request header.
diff --git a/docs/api/response.md b/docs/api/response.md
index fa79126..00ba8a4 100644
--- a/docs/api/response.md
+++ b/docs/api/response.md
@@ -6,19 +6,19 @@
 
 ## API
 
-### res.header
+### response.header
 
   Response header object.
 
-### res.socket
+### response.socket
 
   Request socket.
 
-### res.status
+### response.status
 
-  Get response status. By default, `res.status` is not set unlike node's `res.statusCode` which defaults to `200`.
+  Get response status. By default, `response.status` is not set unlike node's `res.statusCode` which defaults to `200`.
 
-### res.status=
+### response.status=
 
   Set response status via numeric code:
 
@@ -83,20 +83,20 @@ __NOTE__: don't worry too much about memorizing these strings,
 if you have a typo an error will be thrown, displaying this list
 so you can make a correction.
 
-### res.length=
+### response.length=
 
   Set response Content-Length to the given value.
 
-### res.length
+### response.length
 
   Return response Content-Length as a number when present, or deduce
-  from `res.body` when possible, or `undefined`.
+  from `this.body` when possible, or `undefined`.
 
-### res.body
+### response.body
 
   Get response body.
 
-### res.body=
+### response.body=
 
   Set response body to one of the following:
 
@@ -106,7 +106,7 @@ so you can make a correction.
   - `Object` json-stringified
   - `null` no content response
 
-  If `res.status` has not been set, Koa will automatically set the status to `200` or `204`.
+  If `response.status` has not been set, Koa will automatically set the status to `200` or `204`.
 
 #### String
 
@@ -126,7 +126,7 @@ so you can make a correction.
 
   The Content-Type is defaulted to application/json.
 
-### res.get(field)
+### response.get(field)
 
   Get a response header field value with case-insensitive `field`.
 
@@ -134,7 +134,7 @@ so you can make a correction.
 var etag = this.get('ETag');
 ```
 
-### res.set(field, value)
+### response.set(field, value)
 
   Set response header `field` to `value`:
 
@@ -142,7 +142,7 @@ var etag = this.get('ETag');
 this.set('Cache-Control', 'no-cache');
 ```
 
-### res.set(fields)
+### response.set(fields)
 
   Set several response header `fields` with an object:
 
@@ -157,7 +157,7 @@ this.set({
 
   Remove header `field`.
 
-### res.type
+### response.type
 
   Get response `Content-Type` void of parameters such as "charset".
 
@@ -166,7 +166,7 @@ var ct = this.type;
 // => "image/png"
 ```
 
-### res.type=
+### response.type=
 
   Set response `Content-Type` via mime string or file extension.
 
@@ -178,11 +178,11 @@ this.type = 'png';
 ```
 
   Note: when appropriate a `charset` is selected for you, for
-  example `res.type = 'html'` will default to "utf-8", however
-  when explicitly defined in full as `res.type = 'text/html'`
+  example `response.type = 'html'` will default to "utf-8", however
+  when explicitly defined in full as `response.type = 'text/html'`
   no charset is assigned.
 
-### res.is(types...)
+### response.is(types...)
 
   Very similar to `this.request.is()`.
   Check whether the response type is one of the supplied types.
@@ -208,7 +208,7 @@ app.use(function *minifyHTML(next){
 });
 ```
 
-### res.redirect(url, [alt])
+### response.redirect(url, [alt])
 
   Perform a [302] redirect to `url`.
 
@@ -232,22 +232,22 @@ this.redirect('/cart');
 this.body = 'Redirecting to shopping cart';
 ```
 
-### res.attachment([filename])
+### response.attachment([filename])
 
   Set `Content-Disposition` to "attachment" to signal the client
   to prompt for download. Optionally specify the `filename` of the
   download.
 
-### res.headerSent
+### response.headerSent
 
   Check if a response header has already been sent. Useful for seeing
   if the client may be notified on error.
 
-### res.lastModified
+### response.lastModified
 
   Return the `Last-Modified` header as a `Date`, if it exists.
 
-### res.lastModified=
+### response.lastModified=
 
   Set the `Last-Modified` header as an appropriate UTC string.
   You can either set it as a `Date` or date string.
@@ -256,15 +256,15 @@ this.body = 'Redirecting to shopping cart';
 this.response.lastModified = new Date();
 ```
 
-### res.etag=
+### response.etag=
 
   Set the ETag of a response including the wrapped `"`s.
-  Note that there is no corresponding `res.etag` getter.
+  Note that there is no corresponding `response.etag` getter.
 
 ```js
 this.response.etag = crypto.createHash('md5').update(this.body).digest('hex');
 ```
 
-### res.vary(field)
+### response.vary(field)
 
   Vary on `field`.