Adjustments for release notes

* add a link to README.rst
* reverse chronological order of notes

README.rst

@@ -7,6 +7,8 @@
 Gabbi
 =====
 
+`Release Notes`_
+
 Gabbi is a tool for running HTTP tests where requests and responses
 are represented in a declarative YAML-based form. The simplest test
 looks like this::
@@ -27,6 +29,7 @@ There is a `gabbi-demo`_ repository which provides a tutorial via
 its commit history. The demo builds a simple API using gabbi to
 facilitate test driven development.
 
+.. _Release Notes: https://gabbi.readthedocs.io/en/latest/release.html
 .. _docs: https://gabbi.readthedocs.io/
 .. _gabbi-demo: https://github.com/cdent/gabbi-demo
 .. _unittest: https://gabbi.readthedocs.io/en/latest/example.html#loader

docs/source/release.rst

@@ -5,35 +5,53 @@ These are informal release notes for gabbi since version 1.0.0,
 highlighting major features and changes. For more detail see
 the `commit logs`_ on GitHub.
 
-1.0.0
------
+1.22.0
+------
 
-Version 1 was the first release with a commitment to a stable
-:doc:`format`. Since then new fields have been added but have not
-been taken away.
+Add ``url`` to :meth:`gabbi.driver.build_tests` to use instead of
+``host``, ``port`` and ``prefix``.
 
-1.1.0
------
+1.21.0
+------
 
-Vastly improved output and behavior in :doc:`gabbi-run <runner>`.
+Add ``require_ssl`` to :meth:`gabbi.driver.build_tests` to force use
+of SSL.
 
-1.2.0
------
+1.20.0
+------
 
-The start of improvements and extensions to :doc:`jsonpath`
-handling. In this case the addition of the ``len`` function.
+Add ``$COOKIE`` :ref:`substitution <state-substitution>`.
 
-1.3.0
------
+1.19.1
+------
 
-Adds the ``query_parameters`` key to :ref:`request parameters
-<request-parameters>`.
+Correctly support IPV6 hosts.
 
-1.4.0 and 1.5.0
----------------
+1.19.0
+------
 
-Enhanced flexibility and colorization when setting tests to be
-:ref:`verbose <metadata>`.
+Add ``$LAST_URL`` :ref:`substitution <state-substitution>`.
+
+1.17.0
+------
+
+Introduce support for loading and running tests with pytest.
+
+1.16.0
+------
+
+Use urllib3 instead of httplib2 for driving HTTP requests.
+
+1.13.0
+------
+
+Add sorting and filtering to :doc:`jsonpath` handling.
+
+1.11.0
+------
+
+Add the ``response_forbidden_headers`` to :ref:`response expectations
+<response-expectations>`.
 
 1.7.0
 -----
@@ -55,57 +73,38 @@ Instead of::
 
 Any upper case key is treated as a method.
 
-1.11.0
-------
+1.4.0 and 1.5.0
+---------------
 
-Add the ``response_forbidden_headers`` to :ref:`response expectations
-<response-expectations>`.
+Enhanced flexibility and colorization when setting tests to be
+:ref:`verbose <metadata>`.
 
-1.13.0
-------
+1.3.0
+-----
 
-Add sorting and filtering to :doc:`jsonpath` handling.
+Adds the ``query_parameters`` key to :ref:`request parameters
+<request-parameters>`.
 
-1.16.0
-------
+1.2.0
+-----
 
-Use urllib3 instead of httplib2 for driving HTTP requests.
+The start of improvements and extensions to :doc:`jsonpath`
+handling. In this case the addition of the ``len`` function.
 
-1.17.0
-------
+1.1.0
+-----
 
-Introduce support for loading and running tests with pytest.
+Vastly improved output and behavior in :doc:`gabbi-run <runner>`.
 
-1.19.0
-------
-
-Add ``$LAST_URL`` :ref:`substitution <state-substitution>`.
-
-1.19.1
-------
-
-Correctly support IPV6 hosts.
-
-1.20.0
-------
-
-Add ``$COOKIE`` :ref:`substitution <state-substitution>`.
-
-1.21.0
-------
-
-Add ``require_ssl`` to :meth:`gabbi.driver.build_tests` to force use
-of SSL.
-
-1.22.0
-------
-
-Add ``url`` to :meth:`gabbi.driver.build_tests` to use instead of
-``host``, ``port`` and ``prefix``.
+1.0.0
+-----
 
+Version 1 was the first release with a commitment to a stable
+:doc:`format`. Since then new fields have been added but have not
+been taken away.
 
 Contributors
-------------
+============
 
 The following people have contributed code to gabbi. Thanks to them.
 Thanks also to all the people who have made gabbi better by