README.md in sensu-plugins-sensu-2.0.0 vs README.md in sensu-plugins-sensu-2.1.0

@@ -8,16 +8,50 @@
 
 ## Functionality
 
 ## Files
  * bin/check-aggregate.rb
+ * bin/check-stale-results.rb
  * bin/metrics-aggregate.rb
  * bin/metrics-delete-expired-stashes.rb
  * bin/metrics-events.rb
  * bin/handler-sensu.rb
  * bin/handler-sensu-deregister.rb
+ * bin/handler-purge-stale-results.rb
 
 ## Usage
+
+### check-stale-results.rb
+
+A sensu plugin to monitor sensu stale check results. You can then implement an handler that purges the results after X days using the `handlers-purge-stale-results` handler.
+
+The plugin accepts the following command line options:
+
+```
+Usage: check-stale-results.rb (options)
+    -c, --crit <COUNT>               Critical if number of stale check results exceeds COUNT
+    -s, --stale <TIME>               Elapsed time to consider a check result result (default: 1d)
+    -v, --verbose                    Be verbose
+    -w, --warn <COUNT>               Warn if number of stale check results exceeds COUNT (default: 1)
+```
+
+the --stale command line option accepts elapsed times formatted as documented in https://github.com/hpoydar/chronic_duration.
+
+The handler accepts the following command line options:
+
+### handler-purge-stale-results.rb
+
+A sensu handler to purge stale check results. This handler can be invoked from a check that uses the the `check-stale-results` plugin.
+
+```
+Usage: handler-purge-stale-results.rb (options)
+        --mail-recipient <ADDRESS>   Mail recipient (required)
+        --mail-sender <ADDRESS>      Mail sender (default: sensu@localhost)
+        --mail-server <HOST>         Mail server (default: localhost)
+    -s, --stale <TIME>               Elapsed time after which a stale check result will be deleted (default: 7d)
+```
+
+the --stale command line option accepts elapsed times formatted as documented in https://github.com/hpoydar/chronic_duration.
 
 ## Installation
 
 [Installation and Setup](http://sensu-plugins.io/docs/installation_instructions.html)