Merge branch '2.9-docs'

Author: andrew-codechimp

docs/events.md

@@ -24,6 +24,7 @@ You can use this to send notifications in your preferred method.  An example aut
 | `battery_quantity` | `int` | Battery quantity. |
 | `battery_level` | `float` | Battery level % of the device. |
 | `previous_battery_level` | `float` | Previous battery level % of the device. |
+| `battery_last_replaced` | `datetime` | The date the battery was last replaced. |
 | `reminder` | `bool` | Returns true if the event was raised by an action, false if it's from a device event. |  
 
 ### Automation Example
@@ -98,6 +99,7 @@ An example automation below shows how to update the battery_replaced.
 | `battery_quantity` | `int` | Battery quantity. |
 | `battery_level` | `float` | Current battery level % of the device. |
 | `previous_battery_level` | `float` | Previous battery level % of the device. |
+| `battery_last_replaced` | `datetime` | The date the battery was last replaced. |
 
 ### Automation Example
 
@@ -137,6 +139,7 @@ The action can raise multiple events quickly so when using with an automation it
 | `battery_last_reported` | `datetime` | The datetime the battery was last reported. |
 | `battery_last_reported_days` | `int` | The number of days since the battery was last reported. |
 | `battery_last_reported_level` | `float` | The level of the battery when it was last reported. |
+| `battery_last_replaced` | `datetime` | The date the battery was last replaced. |
 
 ### Automation Example
 

docs/index.md

@@ -59,6 +59,9 @@ Example templates
 
     If a template is specified then the battery percentage will be ignored when evaluating threshold and increased events. 
 
+## Filter Outliers
+This is for advanced use when a device occasionally erroneously reports a very low battery level occasionally before going back to it's true value, which causes battery low events to be raised.  
+If you switch this on for a device then that devices battery low events will be delayed until it has three consistently low states.
 
 ## Community Contributions