[WIP] update code docs for SetRequestTimeout

Octokit.Reactive/IObservableGitHubClient.cs

@@ -7,7 +7,8 @@ public interface IObservableGitHubClient : IApiInfoProvider
         IConnection Connection { get; }
 
         /// <summary>
-        /// Set the GitHub Api request timeout.
+        /// Sets the timeout for the connection between the client and the server.
+        /// Github will terminate the request if it takes more than 10 seconds to process the request
         /// Useful to set a specific timeout for lengthy operations, such as uploading release assets
         /// </summary>
         /// <remarks>

Octokit.Reactive/ObservableGitHubClient.cs

@@ -57,7 +57,8 @@ public IConnection Connection
         }
 
         /// <summary>
-        /// Set the GitHub Api request timeout.
+        /// Sets the timeout for the connection between the client and the server.
+        /// Github will terminate the request if it takes more than 10 seconds to process the request
         /// Useful to set a specific timeout for lengthy operations, such as uploading release assets
         /// </summary>
         /// <remarks>

Octokit/GitHubClient.cs

@@ -114,7 +114,7 @@ public GitHubClient(IConnection connection)
         }
 
         /// <summary>
-        /// Set the GitHub Api request timeout.
+        /// Sets the timeout for the connection between the client and the server.
         /// Useful to set a specific timeout for lengthy operations, such as uploading release assets
         /// </summary>
         /// <remarks>

Octokit/Http/Connection.cs

@@ -832,7 +832,7 @@ static string GetVersionInformation()
         }
 
         /// <summary>
-        /// Set the GitHub Api request timeout.
+        /// Sets the timeout for the connection between the client and the server.
         /// </summary>
         /// <param name="timeout">The Timeout value</param>
         public void SetRequestTimeout(TimeSpan timeout)

Octokit/Http/IConnection.cs

@@ -327,7 +327,7 @@ Task<IApiResponse<T>> Post<T>(
         Credentials Credentials { get; set; }
 
         /// <summary>
-        /// Set the GitHub Api request timeout.
+        /// Sets the timeout for the connection between the client and the server.
         /// </summary>
         /// <param name="timeout">The Timeout value</param>
         void SetRequestTimeout(TimeSpan timeout);

Octokit/Http/IHttpClient.cs

@@ -22,7 +22,7 @@ public interface IHttpClient : IDisposable
 
 
         /// <summary>
-        /// Set the GitHub API request timeout.
+        /// Sets the timeout for the connection between the client and the server.
         /// </summary>
         /// <param name="timeout">The Timeout value</param>
         void SetRequestTimeout(TimeSpan timeout);

Octokit/IGitHubClient.cs

@@ -8,7 +8,8 @@ namespace Octokit
     public interface IGitHubClient : IApiInfoProvider
     {
         /// <summary>
-        /// Set the GitHub API request timeout.
+        /// Sets the timeout for the connection between the client and the server.
+        /// Github will terminate the request if it takes more than 10 seconds to process the request
         /// Useful to set a specific timeout for lengthy operations, such as uploading release assets
         /// </summary>
         /// <remarks>