docs(client): document max retries

Author: stainless-app[bot]

README.md

@@ -131,6 +131,42 @@ false
 
 ## Network options
 
+### Retries
+
+The SDK automatically retries 2 times by default, with a short exponential backoff between requests.
+
+Only the following error types are retried:
+
+- Connection errors (for example, due to a network connectivity problem)
+- 408 Request Timeout
+- 409 Conflict
+- 429 Rate Limit
+- 5xx Internal
+
+The API may also explicitly instruct the SDK to retry or not retry a request.
+
+To set a custom number of retries, configure the client using the `MaxRetries` method:
+
+```csharp
+using ArcadeDotnet;
+
+ArcadeClient client = new() { MaxRetries = 3 };
+```
+
+Or configure a single method call using [`WithOptions`](#modifying-configuration):
+
+```csharp
+using System;
+
+var chatResponse = await client
+    .WithOptions(options =>
+        options with { MaxRetries = 3 }
+    )
+    .Chat.Completions.Create();
+
+Console.WriteLine(chatResponse);
+```
+
 ### Timeouts
 
 Requests time out after 1 minute by default.

src/ArcadeDotnet/ArcadeClient.cs

@@ -46,18 +46,18 @@ public bool ResponseValidation
         init { this._options.ResponseValidation = value; }
     }
 
-    public TimeSpan Timeout
-    {
-        get { return this._options.Timeout; }
-        init { this._options.Timeout = value; }
-    }
-
     public int MaxRetries
     {
         get { return this._options.MaxRetries; }
         init { this._options.MaxRetries = value; }
     }
 
+    public TimeSpan Timeout
+    {
+        get { return this._options.Timeout; }
+        init { this._options.Timeout = value; }
+    }
+
     public string APIKey
     {
         get { return this._options.APIKey; }

src/ArcadeDotnet/Core/ClientOptions.cs

@@ -19,10 +19,10 @@ public Uri BaseUrl
 
     public bool ResponseValidation { get; set; } = false;
 
-    public TimeSpan Timeout { get; set; } = TimeSpan.FromMinutes(1);
-
     public int MaxRetries { get; set; } = 2;
 
+    public TimeSpan Timeout { get; set; } = TimeSpan.FromMinutes(1);
+
     /// <summary>
     /// API key used for authorization in header
     /// </summary>

src/ArcadeDotnet/IArcadeClient.cs

@@ -20,10 +20,10 @@ public interface IArcadeClient
 
     bool ResponseValidation { get; init; }
 
-    TimeSpan Timeout { get; init; }
-
     int MaxRetries { get; init; }
 
+    TimeSpan Timeout { get; init; }
+
     /// <summary>
     /// API key used for authorization in header
     /// </summary>