diff --git a/src/documentation/patterns.ts b/src/documentation/patterns.ts
index 0f73585..43bc49c 100644
--- a/src/documentation/patterns.ts
+++ b/src/documentation/patterns.ts
@@ -111,7 +111,7 @@ beat([.5, 1].random() / 2) :: snd(
 
 ${makeExample(
   "Generate a list of random numbers",
-  `beat(0.5) && sound('arp').freq([].gen(300,600,10).div(3)).out()`,
+  `beat(0.5) && sound('arp').freq([].gen(300,600,10).beat()).out()`,
   true
 )}
 
diff --git a/src/documentation/ziffers.ts b/src/documentation/ziffers.ts
index 104bbb5..d0e06ea 100644
--- a/src/documentation/ziffers.ts
+++ b/src/documentation/ziffers.ts
@@ -152,6 +152,14 @@ ${makeExample(
 `
 )}
 
+${makeExample(
+  "Programmatic inversions",
+  `
+  z1('i v vi iv').invert([1,-1,-2,0].beat(4))
+  .sound("sawtooth").out()
+  `
+)}
+
 ## Algorithmic operations
 
 Ziffers provides shorthands for **many** numeric and algorithimic operations such as evaluating random numbers and creating sequences using list operations: