diff --git a/index.html b/index.html
index c9a1423..77a2dd4 100644
--- a/index.html
+++ b/index.html
@@ -163,11 +163,11 @@
                 <details class="space-y-2" open=false>
                   <summary class="ml-2 lg:text-xl pb-1 pt-1 text-white">Audio Engine</summary>
                   <div class="flex flex-col">
-                    <p rel="noopener noreferrer" id="docs_audio_basics" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Basics</p>
+                    <p rel="noopener noreferrer" id="docs_audio_basics" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Playing a sound</p>
                     <p rel="noopener noreferrer" id="docs_amplitude" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Amplitude</p>
                     <p rel="noopener noreferrer" id="docs_sampler" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Sampler</p>
-                    <p rel="noopener noreferrer" id="docs_reverb_delay" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Reverb & Delay</p>
-                    <p rel="noopener noreferrer" id="docs_distortion" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Distortion</p>
+                    <p rel="noopener noreferrer" id="docs_synths" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Synths</p>
+                    <p rel="noopener noreferrer" id="docs_reverb_delay" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Effects</p>
                   </div>
                 </details>
 
@@ -175,14 +175,12 @@
                 <details class="space-y-2" open=false>
                   <summary class="ml-2 lg:text-xl pb-1 pt-1 text-white">Samples</summary>
                   <div class="flex flex-col">
-                    <p rel="noopener noreferrer" id="docs_sample_list" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Samples List</p>
+                    <p rel="noopener noreferrer" id="docs_sample_list" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">List of samples</p>
                     <p rel="noopener noreferrer" id="docs_loading_samples" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Loading Samples</p>
                   </div>
                 </details>
 
                 <p rel="noopener noreferrer" id="docs_patterns" class="pl-2 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Patterns</p>
-                <p rel="noopener noreferrer" id="docs_samples" class="pl-2 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Samples</p>
-                <p rel="noopener noreferrer" id="docs_synths" class="pl-2 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Synths</p>
                 <p rel="noopener noreferrer" id="docs_midi" class="pl-2 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">MIDI</p>
 							</div>
 						</details>
diff --git a/src/Documentation.ts b/src/Documentation.ts
index 2745c13..2cc30f0 100644
--- a/src/Documentation.ts
+++ b/src/Documentation.ts
@@ -3,7 +3,6 @@ import { type Editor } from "./main";
 import { introduction } from "./documentation/basics/welcome";
 import { loading_samples } from "./documentation/samples/loading_samples";
 import { amplitude } from "./documentation/audio_engine/amplitude";
-import { distortion } from "./documentation/audio_engine/distortion";
 import { reverb } from "./documentation/audio_engine/reverb_delay";
 import { sampler } from "./documentation/audio_engine/sampler";
 import { sample_banks } from "./documentation/samples/sample_banks";
@@ -99,7 +98,6 @@ export const documentation_factory = (application: Editor) => {
     reference: reference(),
     shortcuts: shortcuts(application),
     amplitude: amplitude(application),
-    distortion: distortion(application),
     reverb_delay: reverb(application),
     sampler: sampler(application),
     mouse: mouse(application),
diff --git a/src/InterfaceLogic.ts b/src/InterfaceLogic.ts
index 3b22a2b..d89ce1a 100644
--- a/src/InterfaceLogic.ts
+++ b/src/InterfaceLogic.ts
@@ -485,7 +485,6 @@ export const installInterfaceLogic = (app: Editor) => {
     "amplitude",
     "audio_basics",
     "reverb_delay",
-    "distortion",
     "interface",
     "interaction",
     "code",
diff --git a/src/documentation/audio_engine/audio_basics.ts b/src/documentation/audio_engine/audio_basics.ts
index 81f577e..108110f 100644
--- a/src/documentation/audio_engine/audio_basics.ts
+++ b/src/documentation/audio_engine/audio_basics.ts
@@ -67,7 +67,7 @@ Try to remove <ic>.out</ic>. You will see that no sound is playing at all!
 - Sounds are **composed** by adding qualifiers/parameters that modify the sound or synthesizer you have picked (_e.g_ <ic>sound('...').blabla(...)..something(...).out()</ic>. Think of it as _audio chains_. 
 	
 ${makeExample(
-    '"Composing" a complex sonic object by making a sound chain',
+    'Complex sonic object',
     `
 beat(1) :: sound('pad').n(1)
   .begin(rand(0, 0.4))
diff --git a/src/documentation/audio_engine/reverb_delay.ts b/src/documentation/audio_engine/reverb_delay.ts
index 8d01cf4..e52869c 100644
--- a/src/documentation/audio_engine/reverb_delay.ts
+++ b/src/documentation/audio_engine/reverb_delay.ts
@@ -4,7 +4,11 @@ import { makeExampleFactory } from "../../Documentation";
 export const reverb = (application: Editor): string => {
   // @ts-ignore
   const makeExample = makeExampleFactory(application);
-  return `# Reverberation and delay
+  return `
+
+# Audio effects
+
+There is a growing collection of audio effects you can use directly baked in the engine. You can create a wide variety of sonic effects by being creative with the parameters they offer.
 
 ## Reverb
 	
@@ -26,7 +30,6 @@ beat(2)::snd('cp').room(0.5).size(4).out()
 	`,
     true
   )};
-
 	
 ## Delay
 	
@@ -39,14 +42,45 @@ A good sounding delay unit that can go into feedback territory. Use it without m
 | <ic>delayfeedback</ic> | delayfb | Delay feedback (between <ic>0</ic> and <ic>1</ic>) |
 	
 ${makeExample(
-    "Who doesn't like delay?",
-    `
+    "Who doesn't like delay?", `
 beat(2)::snd('cp').delay(0.5).delaytime(0.75).delayfb(0.8).out()
 beat(4)::snd('snare').out()
-beat(1)::snd('kick').out()
-	`,
-    true
-  )};
-	
+beat(1)::snd('kick').out()`, true)}
 
+## Phaser
+
+| Method     | Alias     | Description                     |
+|------------|-----------|---------------------------------|
+| <ic>phaser</ic> | <ic>phas</ic>  | Phaser speed, between <ic>1</ic> and <ic>n</ic> |
+| <ic>phaserDepth</ic> | <ic>phasdepth</ic>  | How much of the signal goes through phaser (<ic>0</ic> to <ic>1</ic>) |
+| <ic>phaserSweep</ic> | <ic>phassweep</ic>  | Phaser frequency sweep (in hertz) |
+| <ic>phaserCenter</ic> | <ic>phascenter</ic>  | Phaser center frequency (default to 1000) |
+
+${makeExample("Super cool phaser lick", `
+rhythm(.5, 7, 8)::sound('wt_stereo')
+  .phaser(0.75).phaserSweep(3000)
+  .phaserCenter(1500).phaserDepth(1)
+  .note([0, 1, 2, 3, 4, 5, 6].scale('pentatonic', 50).beat(0.25))
+  .room(0.5).size(4).out()
+`, true)}
+
+## Distorsion, saturation, destruction
+
+Three additional effects that are easy enough to understand. These effects are deteriorating the signal, making it easy to get digital or gritty audio sample playback or synthesizers destroyed beyond recognition. Be careful with your signal level!
+	
+| Method     | Alias     | Description                     |
+|------------|-----------|---------------------------------|
+| <ic>coarse</ic>     |           | Artificial sample-rate lowering |
+| <ic>crush</ic>      |           | bitcrushing. <ic>1</ic> is extreme, the more you go up, the less it takes effect.  |
+| <ic>shape</ic>      |           | Waveshaping distortion (between <ic>0</ic> and <ic>1</ic>)          |
+	
+	
+${makeExample(
+      "Crunch... crunch... crunch!",
+      `
+beat(.5)::snd('pad').coarse($(1) % 16).clip(.5).out(); // Comment me
+beat(.5)::snd('pad').crush([16, 8, 4].beat(2)).clip(.5).out()
+	`,
+      true
+    )};
 `}