Merged PR 15806: filling OGF gaps, and improving writing.

filling gaps, improving writing

Author: Steven White

windows.devices.lights.effects/ilamparrayeffect.md

@@ -12,9 +12,10 @@ public interface ILampArrayEffect
 
 ## -description
 
+The base interface for lamp array effects.
+
 ## -remarks
 
 ## -see-also
 
-## -examples
-
+## -examples

windows.devices.lights.effects/ilamparrayeffect_zindex.md

@@ -12,11 +12,14 @@ public int ZIndex { get;  set; }
 
 ## -description
 
+Gets and sets the front-to-back z-index of a lamp array effect within a collection.
+
 ## -property-value
 
+The front-to-back z-index of a lamp array effect within a collection.
+
 ## -remarks
 
 ## -see-also
 
-## -examples
-
+## -examples

windows.devices.lights.effects/lamparraybitmapeffect.md

@@ -16,9 +16,9 @@ Renders a series of images to selected lamp indexes on the device.
 ## -remarks
 Effect captures a series of images, by the caller subscribing to the [BitmapRequested](lamparraybitmapeffect_bitmaprequested.md) event and calling [UpdateBitmap](lamparraybitmaprequestedeventargs_updatebitmap_191710798.md) when triggered. This allows for images created on-the-fly to be supplied to the effect.
 
-Best effort is done to create a 2D composition of requested lamps and scale up/down images.
+Best effort is made to create a 2D composition of requested lamps and scale up/down images.
 
-Must be [Appended](lamparrayeffectplaylist_append_292269384.md) to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md) before can be played.
+Before you can play an effect, you must append it to a **LampArrayEffectPlaylist** (see [Append](lamparrayeffectplaylist_append_292269384.md)).
 
 If a [LampArray](../windows.devices.lights/lamparray.md) is bound to a LampArrayBitmapEffect and it disconnects, progress of the effect continues as a no-op.  No exception/error is thrown/returned.
 ## -see-also

windows.devices.lights.effects/lamparraybitmapeffect_duration.md

@@ -17,7 +17,7 @@ Gets or sets the duration of the effect.
 Default value is 0.
 
 ## -remarks
-Once the effect has been [Appended](lamparrayeffectplaylist_append_292269384.md) to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value is locked and is no longer possible to set the value.
+After you've appended (see [Append](lamparrayeffectplaylist_append_292269384.md)) an effect to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value of this property is locked, and you can no longer change it.
 
 ## -see-also
 

windows.devices.lights.effects/lamparraybitmapeffect_startdelay.md

@@ -19,7 +19,7 @@ Default value is 0.
 ## -remarks
 If within an [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), delay will be evaluated every time playlist repeats.
 
-Once the effect has been [Appended](lamparrayeffectplaylist_append_292269384.md) to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value is locked and is no longer possible to set the value.
+After you've appended (see [Append](lamparrayeffectplaylist_append_292269384.md)) an effect to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value of this property is locked, and you can no longer change it.
 
 ## -see-also
 

windows.devices.lights.effects/lamparraybitmapeffect_updateinterval.md

@@ -17,7 +17,7 @@ Gets or sets the interval between the triggering of the [BitmapRequested](lampar
 Time interval between updates. Default value is 0.
 
 ## -remarks
-Once the effect has been [Appended](lamparrayeffectplaylist_append_292269384.md) to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value is locked and is no longer possible to set the value.
+After you've appended (see [Append](lamparrayeffectplaylist_append_292269384.md)) an effect to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value of this property is locked, and you can no longer change it.
 
 ## -see-also
 

windows.devices.lights.effects/lamparraybitmapeffect_zindex.md

@@ -21,7 +21,7 @@ Higher zIndex implies higher precedence.
 
 If two effects with the same zIndex operate on the same lamp (via two separate [LampArrayEffectPlaylists](lamparrayeffectplaylist.md)), the behavior is undefined.
 
-Once the effect has been [Appended](lamparrayeffectplaylist_append_292269384.md) to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value is locked and is no longer possible to set the value.
+After you've appended (see [Append](lamparrayeffectplaylist_append_292269384.md)) an effect to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value of this property is locked, and you can no longer change it.
 
 ## -see-also
 

windows.devices.lights.effects/lamparrayblinkeffect.md

@@ -18,9 +18,9 @@ Always starts from off/[Black](../windows.ui/colors_black.md), attacks to a defi
 
 Will always set the state of lamp/s to off/[Black](../windows.ui/colors_black.md) when effect completes, regardless of progress.
 
-Must be [Appended](lamparrayeffectplaylist_append_292269384.md) to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md) before can be played.
+Before you can play an effect, you must append it to a **LampArrayEffectPlaylist** (see [Append](lamparrayeffectplaylist_append_292269384.md)).
 
-All lamps within the effect behave identically, subject to contraints of the lamp indexes (e.g. color channels).  Best effort will always be done to accommodate lamp index constraints.
+All lamps within the effect behave identically, subject to contraints of the lamp indexes (for example, color channels). Best effort will always be done to accommodate lamp index constraints.
 
 If a [LampArray](../windows.devices.lights/lamparray.md) is bound to a LampArrayBlinkEffect and it disconnects, progress of the effect continues as a no-op. No exception/error is thrown/returned.
 

windows.devices.lights.effects/lamparrayblinkeffect_attackduration.md

@@ -17,7 +17,7 @@ Gets or sets the time spent attacking/ramping-up from off/[Black](../windows.ui/
 Default value is 0.
 
 ## -remarks
-Once the effect has been [Appended](lamparrayeffectplaylist_append_292269384.md) to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value is locked and is no longer possible to set the value.
+After you've appended (see [Append](lamparrayeffectplaylist_append_292269384.md)) an effect to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value of this property is locked, and you can no longer change it.
 
 ## -see-also
 

windows.devices.lights.effects/lamparrayblinkeffect_color.md

@@ -17,7 +17,7 @@ Gets or sets the color of peak intensity for the effect. Duration color is visib
 Default is [Black](../windows.ui/colors_black.md)
 
 ## -remarks
-Once the effect has been [Appended](lamparrayeffectplaylist_append_292269384.md) to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value is locked and is no longer possible to set the value.
+After you've appended (see [Append](lamparrayeffectplaylist_append_292269384.md)) an effect to a [LampArrayEffectPlaylist](lamparrayeffectplaylist.md), the value of this property is locked, and you can no longer change it.
 
 ## -see-also