diff --git a/docs/api.md b/docs/api.md
index 85a9c87..4ef1526 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -499,17 +499,17 @@ store = await storage("my-data-store", storage_class=MyStorage)
 
 ### `@pyscript/core/donkey`
 
-Sometimes you need a Python worker ready and waiting to evaluate any code on
-your behalf. This is the concept behind the JavaScript "donkey". We couldn't
-think of a better way than "donkey" to describe something that is easy to
-understand and shoulders the burden without complaint. This feature
+Sometimes you need an asynchronous Python worker ready and waiting to evaluate
+any code on your behalf. This is the concept behind the JavaScript "donkey". We
+couldn't think of a better way than "donkey" to describe something that is easy
+to understand and shoulders the burden without complaint. This feature
 means you're able to use PyScript without resorting to specialised
 `<script type="py">` style tags. It's just vanilla JavaScript.
 
 Simply `import { donkey } from '@pyscript/core/dist/core.js'` and automatically
 have both a *pyscript* module running on your page and a utility to bootstrap a
-terminal based worker to evaluate any Python code as and when needed in the
-future.
+terminal based worker to asynchronously evaluate any Python code as and when
+needed in the future.
 
 ```js title="A donkey worker"
 import { donkey } from '@pyscript/core/dist/core.js';
@@ -521,7 +521,7 @@ const {
   clear,                // clear() the terminal
   reset,                // reset() the terminal (including colors)
   kill,                 // kill() the worker forever
-} = donkey({
+} = await donkey({
   type: 'py' || 'mpy',  // the Python interpreter to run
   persistent: false,    // use `true` to track globals and locals
   terminal: '',         // optionally set a target terminal container