improved lightshow

docs/multi_led_patterns.md

@@ -8,7 +8,9 @@ grand_parent: Vortex Engine
 
 # Multi-Led Patterns
 
-A multi-led pattern will control all LEDs on the device, therefore **only one** multi-led pattern can be selected at a time.  Each multi-led pattern has a distinct effect or appearance, they use custom logic to decide how colors from the colorset will travel across LEDs.
+A multi-led pattern will control all LEDs on the device, therefore **only one** multi-led pattern can be selected at a time.
+
+Each multi-led pattern uses custom logic to decide how colors will travel across LEDs.
 
 ## The Pattern List
 
@@ -37,4 +39,4 @@ Below is the list of multi-patterns
   splitstrobie
   backstrobe
   materia
-`
+```

docs/single_led_patterns.md

@@ -16,25 +16,21 @@ Unlike multi-led patterns where each pattern is a distinct type, there are **two
  - **Blend Patterns** will smoothly blend from color to color (while strobing)
 
 
-## Basic Patterns
+## Strobe Patterns
 
-Basic patterns cover all possible patterns which blink on and off. They have the following parameters:
- - on duration: how long the led blinks on for
- - off duration: how long the led is off each blink
- - gap duration: how large of a gap between each volley of colors
- - dash duration: how large of a dash/line embedded in the gap
- - grouping size: how many colors appear in a group before the gap
+Strobe patterns are the most basic kind of pattern, they simply blink from color to color in the colorset.  A strobe pattern has the following parameters:
+
+ - **on duration**: how long the led stays on each 'blink'
+ - **off duration**: the amount of time the led stays off between each 'blink'
+ - **gap duration**: the length of the pause after a complete cycle of colors
+ - **dash duration**: how large the extra burst of light is after the gap
+ - **grouping size**: how many blinks appear in a 'group' before the gap
 
 ## Blend Patterns
-Blend patterns are similar to basic patterns but blend between colors in the colorset instead only using the selected colors. They have the following paramters:
- - on duration: how long the led blinks on for
- - off duration: how long the led is off each blink
- - gap duration: how large of a gap between each volley of colors
- - dash duration: how large of a dash/line embedded in the gap
- - grouping size: how many colors appear in a group before the gap
- - blend speed: the speed at which the blend will progress
- - flip count: the number of times the blend will flip to complementary colors
+Blend patterns are nearly identical to strobe patterns but instead of blinking from color to color, they blend between colors in the colorset. They have the same parameters as strobe, plus two extra:
 
+ - **blend speed**: the speed at which the blend will progress
+ - **flip count**: the number of times the blend 'flips' to complementary colors
 
 ## The Pattern List