Document Timeout behavior for RestClientOptions and RestRequest

Co-authored-by: alexeyzimarev <[email protected]>

Author: Copilot

docs/docs/advanced/configuration.md

@@ -172,7 +172,7 @@ RestSharp allows configuring `RestClient` using client options, as mentioned at
 | `RemoteCertificateValidationCallback`        | Custom function to validate the server certificate. Normally, it's used when the server uses a certificate that isn't trusted by default.                                                                                                                                                         |
 | `BaseHost`                                   | Value for the `Host` header sent with each request.                                                                                                                                                                                                                                               |
 | `CookieContainer`                            | Custom cookie container that will be shared among all calls made by the client. Normally not required as RestSharp handles cookies without using a client-level cookie container.                                                                                                                 |
-| `MaxTimeout`                                 | Client-level timeout in milliseconds. If the request timeout is also set, this value isn't used.                                                                                                                                                                                                  |
+| `Timeout`                                | Client-level timeout as `TimeSpan`. Used when the request timeout is not specified using `RestRequest.Timeout`. If not set, the default timeout is 100 seconds. Set to `Timeout.InfiniteTimeSpan` (or `TimeSpan.FromMilliseconds(-1)`) for no timeout. Setting to `TimeSpan.Zero` will cancel the request immediately. Negative values other than -1 millisecond will throw an exception. |
 | `Encoding`                                   | Default request encoding. Override it only if you don't use UTF-8.                                                                                                                                                                                                                                |
 | `ThrowOnDeserializationError`                | Forces the client to throw if it fails to deserialize the response. Remember that not all deserialization issues forces the serializer to throw. Default is `false`, so the client will return a `RestResponse` with deserialization exception details. Only relevant for `Execute...` functions. |
 | `FailOnDeserializationError`                 | When set to `true`, if the client fails to deserialize the response, the response object will have status `Failed`, although the HTTP calls might have been successful. Default is `true`.                                                                                                        |
@@ -213,7 +213,7 @@ Client options apply to all requests made by the client. Sometimes, you want to
 | `Authenticator`              | Overrides the client-level authenticator.                                                                                                                                                                                                                                                                         |
 | `Files`                      | Collection of file parameters, read-only. Use `AddFile` for adding files to the request.                                                                                                                                                                                                                          |
 | `Method`                     | Request HTTP method, default is `GET`. Only needed when using `Execute` or `ExecuteAsync` as other functions like `ExecutePostAsync` will override the request method.                                                                                                                                            |
-| `TImeout`                    | Overrides the client-level timeout.                                                                                                                                                                                                                                                                               |
+| `Timeout`                    | Overrides the client-level timeout. If not set, uses the client timeout or the default of 100 seconds. Set to `Timeout.InfiniteTimeSpan` (or `TimeSpan.FromMilliseconds(-1)`) for no timeout. Setting to `TimeSpan.Zero` will cancel the request immediately. Negative values other than -1 millisecond will throw an exception. |
 | `Resource`                   | Resource part of the remote endpoint URL. For example, when using the client-level base URL `https://localhost:5000/api` and `Resource` set to `weather`, the request will be sent to `https://localhost:5000/api/weather`. It can container resource placeholders to be used in combination with `AddUrlSegment` |
 | `RequestFormat`              | Identifies the request as JSON, XML, binary, or none. Rarely used because the client will set the request format based on the body type if functions like `AddJsonBody` or `AddXmlBody` are used.                                                                                                                 |
 | `RootElement`                | Used by the default deserializers to determine where to start deserializing from. Only supported for XML responses. Does not apply to requests.                                                                                                                                                                   |

src/RestSharp/Options/RestClientOptions.cs

@@ -183,8 +183,16 @@ public RestClientOptions(string baseUrl) : this(new Uri(Ensure.NotEmptyString(ba
     public CookieContainer? CookieContainer { get; set; }
 
     /// <summary>
-    /// Request duration. Used when the request timeout is not specified using <seealso cref="RestRequest.Timeout"/>,
-    /// </summary>
+    /// Request timeout duration. Used when the request timeout is not specified using <seealso cref="RestRequest.Timeout"/>.
+    /// If not set, the default timeout is 100 seconds.
+    /// </summary>
+    /// <remarks>
+    /// <list type="bullet">
+    /// <item><description>Set to <see cref="System.Threading.Timeout.InfiniteTimeSpan"/> (or <c>TimeSpan.FromMilliseconds(-1)</c>) for no timeout</description></item>
+    /// <item><description>Set to <see cref="TimeSpan.Zero"/> to cancel the request immediately</description></item>
+    /// <item><description>Negative values (other than -1 millisecond) will throw <see cref="ArgumentOutOfRangeException"/></description></item>
+    /// </list>
+    /// </remarks>
     public TimeSpan? Timeout { get; set; }
 
     /// <summary>

src/RestSharp/Request/RestRequest.cs

@@ -131,8 +131,16 @@ public RestRequest(Uri resource, Method method = Method.Get)
     public Method Method { get; set; }
 
     /// <summary>
-    /// Custom request timeout
+    /// Custom request timeout. Overrides <see cref="RestClientOptions.Timeout"/> if set.
+    /// If not set, uses the client-level timeout or the default of 100 seconds.
     /// </summary>
+    /// <remarks>
+    /// <list type="bullet">
+    /// <item><description>Set to <see cref="System.Threading.Timeout.InfiniteTimeSpan"/> (or <c>TimeSpan.FromMilliseconds(-1)</c>) for no timeout</description></item>
+    /// <item><description>Set to <see cref="TimeSpan.Zero"/> to cancel the request immediately</description></item>
+    /// <item><description>Negative values (other than -1 millisecond) will throw <see cref="ArgumentOutOfRangeException"/></description></item>
+    /// </list>
+    /// </remarks>
     public TimeSpan? Timeout { get; set; }
 
     /// <summary>