docs: add note about retrying UNAVAILABLE

grpc · Apr 19, 2019 · f5d2082 · f5d2082
1 parent 07f9efe
commit f5d2082
Showing 1 changed file with 2 additions and 1 deletion.
diff --git a/api/src/main/java/io/grpc/Status.java b/api/src/main/java/io/grpc/Status.java
@@ -182,7 +182,8 @@ public enum Code {
     /**
      * The service is currently unavailable.  This is a most likely a
      * transient condition and may be corrected by retrying with
-     * a backoff.
+     * a backoff. Note that it is not always safe to retry
+     * non-idempotent operations.
      *
      * <p>See litmus test above for deciding between FAILED_PRECONDITION,
      * ABORTED, and UNAVAILABLE.