Polish release docs.

docs/source/whatsnew/development.rst

@@ -27,6 +27,14 b' You should be able to update by using:'
 
     pip install ipython --upgrade
 
+
+.. note::
+
+    If your pip version is greater of equal to pip 9.0.1 you will automatically get
+    the most recent version of IPython compatible with your system. THat is to day
+    on Python 2 you will get the latest IPython 5.x bugfix, while in Python 3
+    you will get the latest 6.x stable version.
+
 New completion API and Interface
 --------------------------------
 
@@ -118,13 +126,17 b' of these as well to improve user experience with better error messages and'
 hints.
 
 
-Configurable TerminalInteractiveShell
--------------------------------------
+Configurable TerminalInteractiveShell, readline interface
+---------------------------------------------------------
 
 IPython gained a new ``c.TerminalIPythonApp.interactive_shell_class`` option
 that allow to customize the class used to start the terminal frontend. This
 should allow user to use custom interfaces, like reviving the former readline
-interface which is now a separate package not maintained by the core team.
+interface which is now a separate package not actively maintained by the core
+team. See the project to bring back the readline interface: `rlipython
+<https://github.com/ipython/rlipython>`_.
+
+This change will be backported to the IPython 5.x series.
 
 
 Miscs improvements