[docs] more docs and screenshots

docs/auditory_task.md

@@ -1,2 +1,23 @@
 # Auditory reaction times
 
+![picture](images/auditory_task_screen.png)
+
+Once you press *enter* or *return* an experiment starts and automatically proceeds until all trials are done.
+
+1. An experiment consists of a number of *trials*.
+2. Before ach trial starts there will be a *pause* which is shown by a countdown appearing at the bottom of the screen.
+3. In each trial the stimulus will appear at a random time after trial start.
+4. Press the *spacebar* once you recognize the stimulus.
+5. Press *esc* to abort the experiment (all data recorded in this experiment are discarded).
+
+## Settings
+
+Pressing the cogwheel in the top right corner allows you to change the settings of the experiment. You can do the changes you want and then close the settings screen by pushing the cogwheel button again.
+![settings](images/auditory_settings.png)
+
+By default, when you open the tool the first time, 5 trials recorded, and the stimulus will appear at a random time in the interval between *minimum delay* and *maximum delay* after start of a trial. Before the first and between trials a countdown appears. The *pause* can be adjusted and, as the other settings is given in seconds.
+The *stimulus saliency* slider controls the loudness of the sound. Of course this setting is not absolute and interferes with the general volume of your loudspeakers. Finally, there are three different sounds which can be selected using the dropdown selection.
+
+All changes will be stored and are persisted even after the program is closed.
+
+[back](index.md)

docs/index.md

@@ -1,27 +1,32 @@
 
 # BlipBlop
 
-![blip blop](images/blipblop_logo.png) 
-
-BlipBlop is a tiny tool for measuring reaction times upon auditory or visual stimulation. This tool is open-source. The source code can be found on [GitHub](https://github.com/jgrewe/blipblop). It is published under the MIT open source [license](license.md). 
-Auditory stimuli have been taken from the freedesktop system sounds [freedesktop](https://freedesktop.org)
+![blip blop](images/blipblop_logo.png)
 
+BlipBlop is a tiny tool for measuring reaction times upon auditory or visual stimulation. This tool is open-source. The source code can be found on [GitHub](https://github.com/jgrewe/blipblop). It is published under the MIT open source [license](license.md).
+Auditory stimuli have been taken from the [freedesktop](https://freedesktop.org) system sounds.
 
 ## Main Window
 
-![main screen](images/blipblop_main.png) 
-
-
-### Visual task
-
-Measure reaction times to a visual stimulus that pops in the center of the screen. ([more](visual_task.md))
+![main screen](images/blipblop_main.png)
 
-### Auditory task
+By pressing one of the big icons in the center of the screen you can start an experiment of measuring the [visual](visual_taks.md) or [auditory](auditory_task.md) reaction times. These functions are also available via the **Tasks** menu on top or the buttons in the tool bar (left). Once an experiment has been successfully performed the results can be viewed using the [results screen](results.md) (table icon on the left, or entry in the **Tasks** menu).
+You can make several experiments and all results will be stored unless you start a new session (top button in the tool bar or *new session* entry in the **Tasks** menu) or end the program.
 
-Measure reaction times to a auditory stimulus. ([more](auditory_task.md))
+The basic handling is very simple:
 
-### Results View
+1. Select a task.
+2. Press *enter* or *return* when ready.
+3. Fixate the cross in the center of the screen.
+4. After a countdown and a stimulus will be shown, or played.
+5. Press the *spacebar* as soon as you recognize the stimulus.
+6. By default 5 trials are recorded and the program returns to the main screen once the trials are done. You can press the *esc* key to abort an experiment. All data recorded in that task are discarded.
 
-A simple tablular view that shows the measured reaction times. The data is given in seconds. Select the data and press (**ctrl+c** or **cmd+c**) to copy the selection to clipboard and paste it into your favorite spreadsheet tool for further analysis.
+Follow the links in the text above for more information on the individual screens.
 
+## Hints & Ideas
 
+* Record enough data. You will notice that the reaction times may vary a lot. In order to do proper analyses record enough data.
+* Play with the stimulus saliency (size or opacity of the visual stimulus or volume, sound of the auditory stimulus).
+* Auditory stimuli: compare the performance when closing the eyes or keeping them open.
+* Visual stimuli: do not fixate on the central cross but maybe a spot outside the screen that has the disk appear in the visual periphery.

docs/results.md

@@ -1 +1,8 @@
-# Results view
+# Results view
+
+![results](images/results_table.png)
+
+A simple tablular view that shows the measured reaction times. Each column is one experiment. Hovering with the mouse over the table header shows a little more information about the task. The icon depicts whether it was a visual or auditory task.
+The data is given in seconds. **Invalid** trials (spacebar was pressed before the stimulus actually appeared) are noted with a reaction time of **-1000**
+
+Select the data with the mouse and press (**ctrl+c** or **cmd+c**) to copy the selection to clipboard and paste it into your favorite spreadsheet tool for further analysis.

docs/visual_task.md

@@ -1,2 +1,25 @@
 # Visual reaction times
 
+![picture](images/visual_task_screen.png)
+
+Once you press *enter* or *return* an experiment starts and automatically proceeds until all trials are done.
+
+1. An experiment consists of a number of *trials*.
+2. Before ach trial starts there will be a *pause* which is shown by a countdown appearing at the bottom of the screen.
+3. In each trial the stimulus will appear at a random time after trial start.
+4. Press the *spacebar* once you recognize the stimulus.
+5. Press *esc* to abort the experiment (all data recorded in this experiment are discarded).
+
+## Settings
+
+Pressing the cogwheel in the top right corner allows you to change the settings of the experiment. You can do the changes you want and then close the settings screen by pushing the cogwheel button again.
+
+![settings](images/visual_settings.png)
+
+By default, when you open the tool the first time, 5 trials recorded, and the stimulus will appear at a random time in the interval between *minimum delay* and *maximum delay* after start of a trial. Before the first and between trials a countdown appears showing the duration of the *pause*.
+
+The visual stimulus is always a red dot appearing centered at the fixation cross. The *stimulus saliency* slider controls the opacity of the red disk. The *stimulus size* slider controls the size of the disk.
+
+All changes will be stored and are persisted even after the program is closed.
+
+[back](index.md)