Clarify max attempts meaning (#546)

Author: slinkydeveloper

sdk-api-kotlin/src/main/kotlin/dev/restate/sdk/kotlin/RetryPolicy.kt

@@ -20,7 +20,7 @@ data class RetryPolicy(
     /** Maximum delay between retries. */
     val maxDelay: Duration? = null,
     /**
-     * Maximum number of attempts before giving up retrying.
+     * Maximum number of attempts, including the initial, before giving up retrying.
      *
      * The policy gives up retrying when either at least the given number of attempts is reached, or
      * the [maxDuration] (if set) is reached first. If both [maxAttempts] and [maxDuration] are

sdk-common/src/main/java/dev/restate/sdk/common/RetryPolicy.java

@@ -45,7 +45,7 @@ public RetryPolicy setMaxDelay(@Nullable Duration maxDelay) {
   }
 
   /**
-   * Maximum number of attempts before giving up retrying.
+   * Maximum number of attempts, including the initial, before giving up retrying.
    *
    * <p>The policy gives up retrying when either at least the given number of attempts is reached,
    * or the {@code maxDuration} specified with {@link #setMaxDuration(Duration)} (if set) is reached