update docs

Author: smurfix

docs/source/history.rst

@@ -4,3 +4,26 @@ Release history
 .. currentmodule:: trio_asyncio
 
 .. towncrier release notes start
+
+Trio_Asyncio 0.8.1 (2018-08-25)
+-------------------------------
+
+Features
+~~~~~~~~
+
+- `trio_ayncio` now contains an `allow_asyncio` wrapper which allows you to
+  seamlessly mix asyncio and trio semantics:: from trio_asyncio import run
+  allow_asyncio async def main(): print("Sleeping 1") await asyncio.sleep(1)
+  print("Sleeping 2") await trio.sleep(1) run(allow_asyncio, main) The problem
+  with this solution is that Trio's cancellations will no longer be converted
+  to asyncio's `CancelledError` within asyncio code. This may or may not be an
+  issue for your code. (`#30
+  <https://github.com/python-trio/trio-asyncio/issues/30>`__)
+
+
+Bugfixes
+~~~~~~~~
+
+- The test suite requires Python 3.6. :mod:`trio_asyncio` itself requires
+  Python 3.5.3. (`#33
+  <https://github.com/python-trio/trio-asyncio/issues/33>`__)

newsfragments/30.feature.rst

@@ -1,3 +1,3 @@
 # This file is imported from __init__.py and exec'd from setup.py
 
-__version__ = "0.8.1"
+__version__ = "0.8.2"