improved README

README.md

@@ -53,23 +53,30 @@ The main menu offers the following features:
 
   * Settle time (tSettle, default 1000ms)
 
-    Pause between motor movement and camera triggers, to avoid shaking.
+    Pause between motor movement and camera triggers, to avoid blurred images
+    because of a shaking camera setup.
 
   * Focus time (tFocus, default 1000ms)
 
-    Half-press of the shutter button, time to let the camera focus.
+    Half-press of the shutter button, time to let the camera focus. Usually you
+    want to use manual focus when using this device, so it doesn't hurt to
+    lower this time.
 
   * Shutter time (tShutter, default 1000ms)
 
-    How long to press the trigger.
+    How long to press the trigger. Note that you have to setup the exposure
+    time on your camera before shooting, this is really only how long the
+    button is pressed.
 
   * Return (default: On)
 
-    Reverse any movement to starting point after shooting the whole scene.
+    Reverse any movement to starting point after shooting the whole scene. This
+    allows to repeat the scene with the same parameters.
 
   * DarkenLCD (default: Off)
 
-    Turn off LCD backlight while shutter is open.
+    Turn off LCD backlight while shutter is open, used to avoid scattered light
+    when shooting in the dark with long exposure time.
 
 * Scene
 
@@ -77,15 +84,18 @@ The main menu offers the following features:
 
   * Steps (nSteps, default 10)
 
-    Number of steps for this scene.
+    Number of steps for this scene. You want to take enough pictures to cover
+    the whole subject.
 
   * Distance per step (distance, default 0.5mm)
 
-    How far to move between the steps.
+    How far to move between the steps. This should be set lower than the
+    estimated depth of field for the setup.
 
 * Run
 
-Run the whole setup.
+  Run the whole setup, starting with settle time and ending with returning to
+  the starting point.
 
 ## Example results