docs: add note about retrying UNAVAILABLE (#2774)

grpc · Apr 15, 2019 · 9d8d97a · 9d8d97a
1 parent 776edd3
commit 9d8d97a
Showing 1 changed file with 2 additions and 1 deletion.
diff --git a/codes/codes.go b/codes/codes.go
@@ -132,7 +132,8 @@ const (
 
 	// Unavailable indicates the service is currently unavailable.
 	// This is a most likely a transient condition and may be corrected
-	// by retrying with a backoff.
+	// by retrying with a backoff. Note that it is not always safe to retry
+	// non-idempotent operations.
 	//
 	// See litmus test above for deciding between FailedPrecondition,
 	// Aborted, and Unavailable.