From a1e572b460f2aeea102142cb4f0543580e79dcdf Mon Sep 17 00:00:00 2001
From: Gyu-Ho Lee <gyuhox@gmail.com>
Date: Thu, 15 Dec 2016 15:12:04 -0800
Subject: [PATCH] dev-guide: add limit.md

---
 Documentation/dev-guide/limit.md | 10 ++++++++++
 Documentation/docs.md            |  4 +++-
 2 files changed, 13 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/dev-guide/limit.md

diff --git a/Documentation/dev-guide/limit.md b/Documentation/dev-guide/limit.md
new file mode 100644
index 000000000..0d7267ebd
--- /dev/null
+++ b/Documentation/dev-guide/limit.md
@@ -0,0 +1,10 @@
+# System limits
+
+## Request size limit
+
+etcd is designed to handle small key value pairs typical for metadata. Larger requests will work, but may increase the latency of other requests. For the time being, etcd guarantees to support RPC requests with up to 1MB of data. In the future, the size limit may be loosened or made it configurable.
+
+## Storage size limit
+
+The default storage size limit is 2GB, configurable with `--quota-backend-bytes` flag; supports up to 8GB.
+
diff --git a/Documentation/docs.md b/Documentation/docs.md
index 3edf1dab9..a30897f03 100644
--- a/Documentation/docs.md
+++ b/Documentation/docs.md
@@ -17,6 +17,7 @@ The easiest way to get started using etcd as a distributed key-value store is to
  - [gRPC naming and discovery][grpc_naming]
  - [Embedding etcd][embed_etcd]
  - [Experimental features and APIs][experimental]
+ - [System limits][system-limit]
 
 ## Operating etcd clusters
 
@@ -60,6 +61,7 @@ Answers to [common questions] about etcd.
 [api_grpc_gateway]: dev-guide/api_grpc_gateway.md
 [clustering]: op-guide/clustering.md
 [conf]: op-guide/configuration.md
+[system-limit]: dev-guide/limit.md
 [common questions]: faq.md
 [data_model]: learning/data_model.md
 [demo]: demo.md
@@ -84,4 +86,4 @@ Answers to [common questions] about etcd.
 [versioning]: op-guide/versioning.md
 [supported_platform]: op-guide/supported-platform.md
 [experimental]: dev-guide/experimental_apis.md
-[v3_upgrade]: upgrades/upgrade_3_0.md
\ No newline at end of file
+[v3_upgrade]: upgrades/upgrade_3_0.md