update README

Author: alexeyraspopov

docs/README.md

@@ -25,6 +25,9 @@ async function doSomethingComplex(data) {
 
 Since React allows as to treat the UI as a first-class citizen, we can mix both things for the sake of solving problems that are the same in React and in just JavaScript code.
 
+This project tends to use the simplicity of functional React components and the essential mechanism of coroutines to create stateful components with data fetching colocation.
+
+The problem of existent solutions in colocating data fetching is an initial complexity of their APIs. These APIs usually tend to provide convenient way for handling one particular use case. This often means possible future issues with handling exceptions or dealing with pending state. However, that's something that can be easily described in terms of the language and may be different based on your opinion or particular task.
 
 ## Install
 
@@ -85,6 +88,40 @@ In the example above, the result component receives `userId` property and uses i
 <PostListCo userId={...} />
 ```
 
+### Async Iterators
+
+[Asynchronous Iterators](https://github.com/tc39/proposal-async-iteration) are in [Stage 3](https://github.com/tc39/proposals) and soon will be added to the language. However, you might want to try them right now, using [Babel](https://babeljs.io/) or [async-to-gen](https://github.com/leebyron/async-to-gen).
+
+```javascript
+async function* CommentListContainer() {
+  yield <LoadingSpinner />;
+
+  try {
+    const comments = await CommentsDAO.retrieve();
+    return <CommentList comments={comments} />;
+  } catch (error) {
+    return <ErrorMessage error={error} />;
+  }
+}
+
+export default Coroutine.create(CommentListContainer);
+```
+
+```javascript
+async function* List() {
+  try {
+    const items = await Items.retrieve();
+    yield <ItemList items={items} />;
+    const additionalInfo = await Info.retrieve();
+    return <ItemList items={items} info={info} />;
+  } catch (error) {
+    return <p>...</p>;
+  }
+}
+
+export default Coroutine.create(List);
+```
+
 ## Testing
 
 Please read the [testing guide](./Testing.md).