diff --git a/doc/4-instrument/ted.md b/doc/4-instrument/ted.md
new file mode 100644
index 00000000..47a5f6d6
--- /dev/null
+++ b/doc/4-instrument/ted.md
@@ -0,0 +1,11 @@
+# TED instrument editor
+
+TED instrument editor consists of these macros:
+
+- **Volume**: volume sequence. **global!**
+- **Arpeggio**: pitch sequence
+- **Square/Noise**: select whether square, noise or nothing will be output
+  - noise only available on channel 2
+  - if square and noise are enabled, square takes precedence.
+- **Pitch**: "fine" pitch
+- **Phase Reset**: trigger restart of waveform. **global!**