Merge pull request grpc#6372 from ctiller/fail_fast

Spell out fail fast semantics
vink007 · Apr 29, 2016 · 90b4a87 · 90b4a87
2 parents f921f2b + 2a932da
commit 90b4a87
Showing 1 changed file with 15 additions and 0 deletions.
diff --git a/doc/fail_fast.md b/doc/fail_fast.md
@@ -0,0 +1,15 @@
+gRPC Fail Fast Semantics
+========================
+
+Fail fast requests allow terminating requests (with status UNAVAILABLE) prior
+to the deadline of the request being met.
+
+gRPC implementations of fail fast can terminate requests whenever a channel is
+in the TRANSIENT_FAILURE or SHUTDOWN states. If the channel is in any other
+state (CONNECTING, READY, or IDLE) the request should not be terminated.
+
+Fail fast SHOULD be the default for gRPC implementations, with an option to
+switch to non fail fast.
+
+The opposite of fail fast is 'ignore connectivity'.
+