Add a sequence diagram for the chained coroutines example

3 files changed, 10 insertions, 1 deletions

diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
index afcfea84a2..8361257402 100644
--- a/Doc/library/asyncio-task.rst
+++ b/Doc/library/asyncio-task.rst
@@ -74,7 +74,6 @@ Print ``"Hello World"`` every two seconds using a coroutine::
     loop = asyncio.get_event_loop()
     loop.run_until_complete(greet_every_two_seconds())
 
-
 .. seealso::
 
    :ref:`Hello World example using a callback <asyncio-hello-world-callback>`.
@@ -104,6 +103,16 @@ Example chaining coroutines::
 ``compute()`` is chained to ``print_sum()``: ``print_sum()`` coroutine waits
 until ``compute()`` is completed before returing its result.
 
+Sequence diagram of the example:
+
+.. image:: tulip_coro.png
+   :align: center
+
+The diagram shows the logical links between the task and the two coroutines, it
+does not describe exactly how things work internally. For example, the sleep
+coroutine creates an internal future which uses
+:meth:`BaseEventLoop.call_later` to wake up the task in 1 second.
+
 
 InvalidStateError
 -----------------
diff --git a/Doc/library/tulip_coro.dia b/Doc/library/tulip_coro.dia
new file mode 100644
index 0000000000..c4e19a0665
--- /dev/null
+++ b/Doc/library/tulip_coro.dia
diff --git a/Doc/library/tulip_coro.png b/Doc/library/tulip_coro.png
new file mode 100644
index 0000000000..e083bc37de
--- /dev/null
+++ b/Doc/library/tulip_coro.png