changelog and upgrade guide

Author: HelloGrayson

CHANGES.rst

@@ -2,14 +2,17 @@ Changelog
 =========
 
 
-0.15.3 (unreleased)
+0.16.0 (unreleased)
 -------------------
 
-- Remove ``broker.py`` and depreciated arg scheme related code.
-- Simplify the TChannel event types. Removed ``operational_error``,
-  ``system_error`` and ``application_error``. Added ``on_error``
-- Remove ``CallableRequestHandler`` and ``BaseRequestHandler``.
-- **BREAKING** - remove ``retry_delay`` option in the ``send`` method.
+- Introduced new server API through methods ``tchannel.TChannel.thrift.register``,
+  ``tchannel.TChannel.json.register``, and ``tchannel.TChannel.raw.register`` - when these
+  methods are used, endpoints are passed a ``tchannel.Request`` object, and are expected to
+  return a ``tchannel.Response`` object. The deprecated ``tchannel.tornado.TChannel.register``
+  continues to function how it did before. Note the breaking change to the top-level TChannel on the next line.
+- **BREAKING** - ``tchannel.TChannel.register`` no longer has the same functionality as ``tchannel.tornado.TChannel.register``,
+  instead it exposes the new server API. See the upgrade guide for details.
+- **BREAKING** - remove ``retry_delay`` option in the ``tchannel.tornado.send`` method.
 
 
 0.15.2 (2015-08-07)

UPGRADE.rst

@@ -7,12 +7,37 @@ what broke and how to safely migrate to newer versions.
 From 0.15 to 0.16
 -----------------
 
+- ``tchannel.TChannel.register`` no longer mimicks ``tchannel.tornado.TChannel.register``,
+  instead it exposes the new server API like so:
+
+  Before:
+
+  .. code:: python
+
+      from tchannel import TChannel
+
+      @tchannel.register('endpoint', 'json')
+      def endpoint(request, response, proxy):
+          response.write({'resp': 'body'})
+
+
+  After:
+
+  .. code:: python
+
+      from tchannel import TChannel, Response
+
+      @tchannel.json.register
+      def endpoint(request):
+          return Response({'resp': 'body'})
+
+
 - Remove ``retry_delay`` option from ``tchannel.tornado.peer.PeerClientOperation.send``
   method.
 
-  Before: ``tchannel.request.send(retry_delay=300)``
+  Before: ``tchannel.tornado.TChannel.request.send(retry_delay=300)``
 
-  After: no more ``retry_delay`` in  ``tchannel.request.send()``
+  After: no more ``retry_delay`` in  ``tchannel.tornado.TChannel.request.send()``
 
 From 0.14 to 0.15
 -----------------