diff --git a/papers/doc/4-instrument/README.md b/papers/doc/4-instrument/README.md
index 30cb62a6..590ffe39 100644
--- a/papers/doc/4-instrument/README.md
+++ b/papers/doc/4-instrument/README.md
@@ -1,14 +1,38 @@
+# instrument list
+
+![instrument list](list.png)
+
+click on an instrument to select it.
+
+double-click to open the instrument editor.
+
 # instrument editor
 
-Depending on a system used, there are currently 10 different types of an instrument editor:
+every instrument can be renamed and have its type changed.
+
+depending on the instrument type, there are currently 10 different types of an instrument editor:
 
 - [FM synthesis](fm.md) - for use with YM2612, YM2151 and FM block portion of YM2610.
-- [Standard](standard.md) - for use with NES and Sega Master System's PSG sound source and it's derivatives. 
+- [Standard](standard.md) - for use with NES and Sega Master System's PSG sound source and its derivatives. 
 - [Game Boy](game-boy.md) - for use with Game Boy APU.
 - [PC Engine/TurboGrafx-16](pce.md) - for use with PC Engine's wavetable synthesizer.
 - [AY8930](8930.md) - for use with Microchip AY8930 E-PSG sound source.
-- [Commodore 64](c64.md) - for use with both revison of Commodore 64's SID.
+- [Commodore 64](c64.md) - for use with Commodore 64 SID.
 - [SAA1099](saa.md) - for use with Philips SAA1099 PSG sound source.
-- [TIA](tia.md) - for use with Atari TIA sound controller.
+- [TIA](tia.md) - for use with Atari 2600 system.
 - [AY-3-8910](ay8910.md) - for use with AY-3-8910 PSG sound source and SSG portion in YM2610.
-- [Amiga/sample](amiga.md) for controlling Amiga and other sample based synthsizers like YM2612's Channel 6 PCM mode, NES channel 5, Sega PCM and PC Engine's sample plyback mode.
+- [Amiga/sample](amiga.md) for controlling Amiga and other sample based synthsizers like YM2612's Channel 6 PCM mode, NES channel 5, Sega PCM and PC Engine's sample playback mode.
+
+# macros
+
+one common feature to instruments is macros (also known as sequences).
+
+these run on every tick and are useful for controlling parameters automatically.
+
+![macro view](macro.png)
+
+to change the loop portion/point, click on the bar under the macro.
+right click on it to disable macro loop.
+
+to change the release point, shift-click the bar under the macro.
+shift-right click on it to remove the release point.
diff --git a/papers/doc/4-instrument/list.png b/papers/doc/4-instrument/list.png
new file mode 100644
index 00000000..d85cea62
Binary files /dev/null and b/papers/doc/4-instrument/list.png differ
diff --git a/papers/doc/4-instrument/macro.png b/papers/doc/4-instrument/macro.png
new file mode 100644
index 00000000..42a2a635
Binary files /dev/null and b/papers/doc/4-instrument/macro.png differ