Changes to definitions around Threshold, Dynamic Energy Ratio etc.
@@ -87,14 +87,15 @@ Other settings are available to further tune how sensitive the Speech to Text (S
* **Phonemes**: The **phonemes** corresponding to the **Wake Word**. If your Wake Word phrase is more than one word, remember to include a period (.) at the end of each phoneme.
-* **Threshold (scientific notation)**: The level of sensitivity at which the **Wake Word** should trigger Mycroft to respond. To *increase* the sensitivity, *reduce* the Threshold. The Threshold is given in [scientific notation](https://en.wikipedia.org/wiki/Scientific_notation). Use this [handy converter](http://www.easysurf.cc/scintd.htm
-) to convert between decimal and scientific notation.
+* **Threshold (scientific notation)**: The level of sensitivity at which the **Wake Word** should trigger Mycroft to respond. To *increase* the sensitivity, *reduce* the Threshold. The Threshold is given in [scientific notation](https://en.wikipedia.org/wiki/Scientific_notation). Use this [handy converter](http://www.easysurf.cc/scintd.htm) to convert between decimal and scientific notation.
-* **Threshold multiplier (float)**:
-@TODO: I don't know what this is / does
+* **Threshold multiplier (float)**: This multiplier acts on the **Threshold**, and may be an easier way to make adjustments rather than scientific notation.
-* **Dynamic Energy Ratio (float)**:
-@TODO: I don't know what this is / does
+* **Dynamic Energy Ratio (float)**: Dynamic Energy Ratio (DER) is one signal feature used in [speech recognition](https://en.wikipedia.org/wiki/Speech_recognition) to identify characteristics of audio, such as whether a person has stopped or started speaking. DER is similar to signal-to-noise-ratio. A high ratio indicates a high difference in signal between speech and no speech, and a low ratio indicates a small difference in signal between speech and no speech.
+
+If Mycroft is being *too sensitive*, reduce this value. If Mycroft *is not being sensitive enough*, increase this value.
+
+@TODO ALL THE ABOVE is educated guessword, and needs to be reviewed by Speech Recognition programmers.
### Telling Mycroft to pick up the new settings
