diff --git a/docs/opcodes/delay_beats.md b/docs/opcodes/delay_beats.md
index 544250649..47903fffa 100644
--- a/docs/opcodes/delay_beats.md
+++ b/docs/opcodes/delay_beats.md
@@ -2,3 +2,16 @@
 template: "sfz/opcode.j2"
 opcode_name: "delay_beats"
 ---
+Used in Cakewalk Dimension Pro and DropZone, alongside [stop_beats], to play slices of loops at specific points in the bar.
+## Examples
+```sfz
+delay_beats=1
+delay_beats=2.25 stop_beats=3
+delay_beats=25.9922 stop_beats=26.0964  
+```
+## Practical Considerations
+In ARIA this opcode can be used, but every region uses up a polyphony voice, and therefore raising polyphony to
+MAX is recommended for sequences beyond a very short length.
+
+
+[stop_beats]: stop_beats.md
diff --git a/docs/opcodes/stop_beats.md b/docs/opcodes/stop_beats.md
index aeaefba91..96cb540b6 100644
--- a/docs/opcodes/stop_beats.md
+++ b/docs/opcodes/stop_beats.md
@@ -2,11 +2,16 @@
 template: "sfz/opcode.j2"
 opcode_name: "stop_beats"
 ---
+Used in Cakewalk Dimension Pro and DropZone, alongside [delay_beats], to play slices of loops at specific points in the bar.
+## Examples
+```sfz
+delay_beats=1 stop_beats=1.5
+delay_beats=25.9922 stop_beats=26.0964  
+```
 ## Practical Considerations
 
-Intended to be a counterpart to [delay_beats] but apparently not actually
-implemented. This opcode passes the parser in ARIA but seems to have no effect
-on its region.
-
+Intended to be a counterpart to [delay_beats] and used in Cakewalk Dimension Pro and DropZone.
+This opcode appears to be not implemented in ARIA - it passes the parser in ARIA but seems to
+have no effect on its region.
 
 [delay_beats]: delay_beats.md