diff --git a/crates/query-ops/README.md b/crates/query-ops/README.md
index edcd325..4c5e2f0 100644
--- a/crates/query-ops/README.md
+++ b/crates/query-ops/README.md
@@ -34,6 +34,7 @@ It uses all three operators:
 - and `natural_join` to attach each book's price.
 
 ```prolog
+% Datalog rule/query
 Q(name, book, dollars) :- author(name, book), bestseller(book), price(book, dollars).
 ```
 
@@ -107,7 +108,7 @@ fn main() {
 }
 ```
 
-How it works:
+How it works (logically):
 
 <div align="center">
   <picture>