From 1212d21440990454b89d1dfc59c85f5a5d1f9a6e Mon Sep 17 00:00:00 2001
From: Nathaniel Manista <nathaniel@google.com>
Date: Mon, 12 Sep 2016 16:05:32 +0000
Subject: [PATCH] Async Python initial document

---
 python/async/README.md   | 25 +++++++++++++++++++++++++
 python/gevents/README.md |  1 -
 2 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 python/async/README.md
 delete mode 100644 python/gevents/README.md

diff --git a/python/async/README.md b/python/async/README.md
new file mode 100644
index 0000000..0a4c455
--- /dev/null
+++ b/python/async/README.md
@@ -0,0 +1,25 @@
+# Asynchronous gRPC Python
+
+We intend to support use of gRPC Python in use cases involving asynchronous frameworks, libraries, and language features.
+
+## Requirements
+
+* Straightforward, attractive, idiomatic developer-user story for using gRPC Python with [the `async`/`await` syntax introduced in Python 3.5](https://docs.python.org/3/whatsnew/3.5.html#pep-492-coroutines-with-async-and-await-syntax).
+* Straightforward, attractive, idiomatic developer-user story for using gRPC Python with [the `asyncio` module introduced in Python 3.4](https://docs.python.org/3/whatsnew/3.4.html#asyncio) or a confident answer about why gRPC Python and `asyncio` needn't be used together or do not conflict.
+* A not-too-painful developer-user story for using gRPC Python in 2.7-and-3.4+ with popular third-party asynchronous frameworks and libraries including
+  * [`gevent`](http://www.gevent.org)
+  * [`tornado`](http://www.tornadoweb.org/en/stable/)
+  * More?
+* Unit test coverage of all supported behaviors introduced to gRPC Python.
+
+## Example application code
+
+When using gRPC Python with Python 3.5+, invoking fifty concurrent RPCs should look like
+```
+# Well, what?
+```
+
+When using gRPC Python with Python 2.7 and `gevent`, invoking an RPC should look like
+```
+# Well?
+```
diff --git a/python/gevents/README.md b/python/gevents/README.md
deleted file mode 100644
index 6637a7e..0000000
--- a/python/gevents/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# In this folder we'll try making grpc-python use gevents.