docs(client): document timeout option

Author: stainless-app[bot]

README.md

@@ -35,7 +35,6 @@ using System;
 using ArcadeDotnet;
 using ArcadeDotnet.Models.Tools;
 
-// Configured using the ARCADE_API_KEY and ARCADE_BASE_URL environment variables
 ArcadeClient client = new();
 
 ToolExecuteParams parameters = new() { ToolName = "Google.ListEmails" };
@@ -45,7 +44,7 @@ var executeToolResponse = await client.Tools.Execute(parameters);
 Console.WriteLine(executeToolResponse);
 ```
 
-## Client Configuration
+## Client configuration
 
 Configure the client using environment variables:
 
@@ -79,15 +78,18 @@ To temporarily use a modified client configuration, while reusing the same conne
 
 ```csharp
 using System;
-using ArcadeDotnet;
 
-IArcadeClient clientWithOptions = client.WithOptions(options =>
-    options with
-    {
-        BaseUrl = new("https://example.com"),
-        Timeout = TimeSpan.FromSeconds(42),
-    }
-);
+var chatResponse = await client
+    .WithOptions(options =>
+        options with
+        {
+            BaseUrl = new("https://example.com"),
+            Timeout = TimeSpan.FromSeconds(42),
+        }
+    )
+    .Chat.Completions.Create();
+
+Console.WriteLine(chatResponse);
 ```
 
 Using a [`with` expression](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/operators/with-expression) makes it easy to construct the modified options.
@@ -127,6 +129,38 @@ false
 
 - `ArcadeException`: Base class for all exceptions.
 
+## Network options
+
+### Timeouts
+
+Requests time out after 1 minute by default.
+
+To set a custom timeout, configure the client using the `Timeout` option:
+
+```csharp
+using System;
+using ArcadeDotnet;
+
+ArcadeClient client = new() { Timeout = TimeSpan.FromSeconds(42) };
+```
+
+Or configure a single method call using [`WithOptions`](#modifying-configuration):
+
+```csharp
+using System;
+
+var chatResponse = await client
+    .WithOptions(options =>
+        options with
+        {
+            Timeout = TimeSpan.FromSeconds(42)
+        }
+    )
+    .Chat.Completions.Create();
+
+Console.WriteLine(chatResponse);
+```
+
 ## Semantic versioning
 
 This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions, though certain backwards-incompatible changes may be released as minor versions: