diff --git a/documentation/build_all.jpg b/documentation/build_all.jpg
new file mode 100644
index 0000000..0c1f7c4
Binary files /dev/null and b/documentation/build_all.jpg differ
diff --git a/documentation/build_docs.md b/documentation/build_docs.md
index f5804cc..b1db9fc 100644
--- a/documentation/build_docs.md
+++ b/documentation/build_docs.md
@@ -8,7 +8,7 @@ these are the parts you need to get. to reduce costs i sourced them through alie
 
 - [raspberry pi3] *37 USD* (watch this space for experiments with other models/sbc's)
 
-![alt text][raspberry pi image]
+![main parts][main parts]
 
 - [raspberry pi screen] *12 USD*
 
@@ -18,7 +18,7 @@ other bits and pieces:
 
 - xxx and yyy size screws and nuts - a few dollars (exact sizes, links etc coming soon)
 
-- >=8 gig mircoSD card
+- 8 gig or greater mircoSD card
 
 - stable 5volt1A microUsb power supply
 
@@ -30,11 +30,11 @@ other bits and pieces:
 
 - 3d print the front panel, back panel and spaces from these files
 
-- 2d print the key mapping (or modify/create your own!) from here onto label paper or something sticky...
+- 2d print these [key stickers] (or modify/create your own!) onto vinyl, label paper or normal paper with double sided tape...
 
 ## put it together
 
-- using etcher (or otherwise) flash the micro sd with this modified image of raspberian (or follow the dotfile instructions here)
+- using [etcher] (or otherwise) flash the micro sd with this modified image of raspberian (or follow these [dotfile] instructions)
 
 - insert sd card into pi
 
@@ -51,6 +51,9 @@ other bits and pieces:
 ## try it owt
 
 [raspberry pi3]:https://www.aliexpress.com/item/RS-Version-2016-New-Raspberry-Pi-3-Model-B-Board-1GB-LPDDR2-BCM2837-Quad-Core-Ras/32789942633.html?spm=a2g0s.9042311.0.0.FkRWty
-[raspberry pi image]: ./images/build_01_pi.jpg
+[main parts]: build_all.jpg
 [raspberry pi screen]:https://www.aliexpress.com/item/New-3-5-inch-Raspberry-Pi-LCD-TFT-Touchscreen-Display-Touch-Shield-Raspberry-pi-2-Model/32605410449.html?spm=a2g0s.9042311.0.0.ZW1WDU
-[usb keypad]:https://www.aliexpress.com/item/2-4G-Wireless-Keyboard-USB-Numeric-Keypad-19-Keys-Mini-Digital-Keyboard-Ultra-Slim-Number-Pad/32818206308.html?spm=a2g0s.9042311.0.0.FkRWty
\ No newline at end of file
+[usb keypad]:https://www.aliexpress.com/item/2-4G-Wireless-Keyboard-USB-Numeric-Keypad-19-Keys-Mini-Digital-Keyboard-Ultra-Slim-Number-Pad/32818206308.html?spm=a2g0s.9042311.0.0.FkRWty
+[key stickers]: https://docs.google.com/document/d/1vhXv5QTfyUqsZuMdQu1lh2dMfEk5HMNVyp8uhrc-I2w/edit?usp=sharing
+[etcher]: https://etcher.io/
+[dotfile] : ./dotfiles/README.md
\ No newline at end of file
diff --git a/documentation/operate_docs.md b/documentation/operate_docs.md
index 1b1d91f..21c057a 100644
--- a/documentation/operate_docs.md
+++ b/documentation/operate_docs.md
@@ -6,7 +6,7 @@
 - connect the hdmi output to the display you want to use
 - power the raspberry pi. you should see red lights on the pi board, some boot text on the hdmi out and the lcd display light up
 - after a few moments , a video should play on the display output , the raspberian desktop will load on lcd and then (after a few moments) the r_e_c_u_r display will load
-- the `DISPLAY` key can be used to cycle through _display_modes_
+- the `DSPLY` key can be used to cycle through _display_modes_
 
 ## controls
 
@@ -14,16 +14,17 @@ the controls on r_e_c_u_r work by mapping `keys` to `actions`. (custom mappings
 
 The exceptions to this are the control keys:
 
-- `<-` and `->` : used for navigation when applicable (see below) ; used for seeking current sample in `SAMPLER` mode
-- `square` : used as 'enter' for navigation ; used to toggle pause/play in `SAMPLER` mode.
+- `<` and `>` : used for navigation when applicable (see below) ; used for seeking current sample in `SAMPLER` mode
+- `■` : used as 'enter' for navigation ; used to toggle pause/play in `SAMPLER` mode.
 
 the display modes described below are cycled by using the `DISPLAY` key. some actions are accessable through a `2ND FUNC` layer, toggled by the corrosponding key.
 other controls include:
 
-- `--->` is used to trigger the next loaded sample to play
+- `→` is used to trigger the next loaded sample to play
 - loading the sample in slot `x` to play next; where `x` is a key from `0` to `9`
 - cropping the current sample to start  (`[`) or end (`]`) at the current time
-- cycling forward (`NEXT BANK`) or back (`PREV BANK`) through the banks of sample , or clearing a bank (`CLEAR BANK`)
+- cycling forward back (`PRV BNK`) or (`NXT BNK`) through the banks of sample , or clearing a bank (`CLR BNK`) (note not implemented yet)
+- `< SPD` and `> SPD` are used to decrease and increase the speed of the currently playing clip (note not implemented yet)
 
 some keys are empty to leave room for future features. i encourage you to make a custom key map (link to doc) or add actions (another link) you would like to use.