diff --git a/README.md b/README.md
index 6d012324..ab167594 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,9 @@ Here is an example transform:
 | `// <anything up to end of line>` | Comment |
 | `{ <key> : <expr> }`               | [Object constructor](tutorial.md#json-construction) |
 | `{ <key> : <expr>, * : . }`        | Specify one key, [copy rest of input](tutorial.md#object-matching) |
+| `5 * 7 + 23.2`        | Arithmetic operations |
+| `7 < 5`        | Comparators |
+| `7 < 5 and .foo == "yes"` | Boolean operators |
 
 ## Using the library
 
diff --git a/tutorial.md b/tutorial.md
index 599207f3..4ff789c0 100644
--- a/tutorial.md
+++ b/tutorial.md
@@ -314,7 +314,11 @@ and get
 ```
 
 You can also combine boolean values with `and` and `or`. `not` is a
-function.
+function. So you can write a boolean expression as:
+
+```
+.foo.bar > 2 and not(contains(.baz, ["george", "harry"]))
+```
 
 ## Object matching