From e0ff9fb7b2451d73cb37a4b348dd08f09471bc8c Mon Sep 17 00:00:00 2001
From: Anna-Karin Salander <salande@amazon.com>
Date: Mon, 7 Feb 2022 10:32:57 -0800
Subject: [PATCH] Clarification on which SdkClientException subclasses may be
 retryable

---
 .../awssdk/core/exception/SdkClientException.java      | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/core/sdk-core/src/main/java/software/amazon/awssdk/core/exception/SdkClientException.java b/core/sdk-core/src/main/java/software/amazon/awssdk/core/exception/SdkClientException.java
index d43a8221a5af..67ba69787c81 100644
--- a/core/sdk-core/src/main/java/software/amazon/awssdk/core/exception/SdkClientException.java
+++ b/core/sdk-core/src/main/java/software/amazon/awssdk/core/exception/SdkClientException.java
@@ -16,15 +16,19 @@
 package software.amazon.awssdk.core.exception;
 
 import software.amazon.awssdk.annotations.SdkPublicApi;
+import software.amazon.awssdk.core.internal.retry.SdkDefaultRetrySetting;
 
 /**
  * Base type for all client exceptions thrown by the SDK.
  *
  * This exception is thrown when service could not be contacted for a response,
  * or when client is unable to parse the response from service.
- *
- * All exceptions that extend {@link SdkClientException} are assumed to be
- * not retryable.
+ * <p>
+ * Exceptions that extend {@link SdkClientException} are assumed to be not retryable, with a few exceptions:
+ * <ul>
+ *     <li>{@link RetryableException} - usable when calls should explicitly be retried</li>
+ *     <li>Exceptions mentioned as a retryable exception in {@link SdkDefaultRetrySetting}</li>
+ * </ul>
  *
  * @see SdkServiceException
  */