From cc6ea790c9b1d0ab2bd253807a0b67c1231d3817 Mon Sep 17 00:00:00 2001
From: Caleb Hailey <caleb@sensu.io>
Date: Wed, 14 Apr 2021 12:55:32 -0700
Subject: [PATCH] updated README.md

---
 README.md | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 07490fe..5638bbe 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,31 @@
 
 ## Overview
 
-Event-based Sensu entity management for service-discovery (add/remove subscriptions) and other automation workflows.
+Event-based Sensu entity management for automated service-discovery (add/remove subscriptions) and other automation workflows.
+The Sensu Entity Manager works with any check plugin or event producer that generates one instruction per line in any of the following formats:
+
+- **Subscriptions (one string per line):**
+
+  ```
+  system/linux
+  postgres
+  ```
+
+- **Labels and Annotations (one `key=value` pair per line):**
+
+  ```
+  region=us-west-2
+  application_id=1001
+  ```
+
+- **Commands (one space-separated `command argument` pair per line):**
+
+  ```
+  add-subscription system/linux
+  add-subscription postgres
+  add-label region=us-west-2
+  add-annotation application_id=1001
+  ```
 
 ## Usage examples