From 9a09f4d236e3fb43b987d7a9583fdd3ce320e225 Mon Sep 17 00:00:00 2001
From: Alex Collins <alex_collins@intuit.com>
Date: Tue, 3 Aug 2021 17:25:35 -0700
Subject: [PATCH] docs: Add LIMITATIONS.md

---
 README.md           |  1 +
 docs/LIMITATIONS.md | 14 ++++++++++++++
 2 files changed, 15 insertions(+)
 create mode 100644 docs/LIMITATIONS.md

diff --git a/README.md b/README.md
index f08c50a1..6fc9282b 100644
--- a/README.md
+++ b/README.md
@@ -72,6 +72,7 @@ Advanced
 
 * [Configuration](docs/CONFIGURATION.md)
 * [Features](docs/FEATURES.md)
+* [Limitations](docs/LIMITATIONS.md)
 * [Metrics](docs/METRICS.md)
 * [Image contract](docs/IMAGE_CONTRACT.md)
 * [Reading material](docs/READING.md)
diff --git a/docs/LIMITATIONS.md b/docs/LIMITATIONS.md
new file mode 100644
index 00000000..0d03f736
--- /dev/null
+++ b/docs/LIMITATIONS.md
@@ -0,0 +1,14 @@
+# Limitations
+
+## Message Size
+
+Messages are handled in memory by Argo Dataflow, so are limited by the amount of memory available x the number of messages cached in memory. 
+
+* HTTP messages must be < 4GB.
+* Kafka messages are typically < 1MB. 
+* NATS streaming messages are < 1MB.
+
+## Message Throughput
+
+* HTTP source tested to 2,000 TPS
+* Sinking is limited by the rate of the sink.
\ No newline at end of file