diff --git a/README.md b/README.md
index f5853ca..bb88a6f 100644
--- a/README.md
+++ b/README.md
@@ -163,6 +163,12 @@ source files, or by launching a REPL for the user:
 
     smallscheme.repl()
 
+... and the new function can then be called from Scheme:
+
+    scheme> (inc 1)
+    ;;=>
+    2
+
 For a full list of data type operators (for converting from Python to
 Scheme and vice-versa), look at
 [dtypes.py](https://github.com/eigenhombre/smallscheme/blob/master/smallscheme/dtypes.py).
diff --git a/examples/interop_example.scm b/examples/interop_example.scm
index 2856a8a..478afa8 100644
--- a/examples/interop_example.scm
+++ b/examples/interop_example.scm
@@ -1,3 +1,8 @@
+;; This code relies on interop_example.py to wire in two new Python functions.
+
+;; Use the Mac's speech synthesis command to speak the following text out loud:
 (say (quote (welcome to the monkey house)))
+
+;; Display all the user logins found by the `last` command:
 (display (lastusers))
 (newline)