Link to the users' guide from the release notes.

diff --git a/docs/guide/coroutines.rst b/docs/guide/coroutines.rst
index 1d5fecc52347ea6a5f2267557340b3f22aa04395..9c5745dc50eb34f391d0f2c76bd2d03ce9322093 100644 (file)
--- a/docs/guide/coroutines.rst
+++ b/docs/guide/coroutines.rst
@@ -33,6 +33,8 @@ Example::
         # instead.
         return response.body
 
+.. _native_coroutines:
+
 Python 3.5: ``async`` and ``await``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

diff --git a/docs/releases/next.rst b/docs/releases/next.rst
index 70655412ed44fe3c9ef4fa469af32c7483d2c84b..a2f6f0afeaaf841868b999b859bea46bd13c89d4 100644 (file)
--- a/docs/releases/next.rst
+++ b/docs/releases/next.rst
@@ -13,7 +13,8 @@ Highlights
   ``yield`` to wait on an asynchronous operation. Coroutines defined with
   async/await will be faster than those defined with ``@gen.coroutine`` and
   ``yield``, but do not support some features including `.Callback`/`.Wait` or
-  the ability to yield a Twisted ``Deferred``.
+  the ability to yield a Twisted ``Deferred``. See :ref:`the users'
+  guide <native_coroutines>` for more.
 * The async/await keywords are also available when compiling with Cython in
   older versions of Python.
 
@@ -144,7 +145,7 @@ Installation
 `tornado.queues`
 ~~~~~~~~~~~~~~~~
 
-* `.Queue` now supports the ``async with`` statement on Python 3.5.
+* `.Queue` now supports the ``async for`` statement on Python 3.5.
 
 `tornado.simple_httpclient`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~