diff --git a/Octokit.Reactive/Clients/IObservableRepositoriesClient.cs b/Octokit.Reactive/Clients/IObservableRepositoriesClient.cs
index 2843a46cb4..7d3218e884 100644
--- a/Octokit.Reactive/Clients/IObservableRepositoriesClient.cs
+++ b/Octokit.Reactive/Clients/IObservableRepositoriesClient.cs
@@ -201,7 +201,9 @@ public interface IObservableRepositoriesClient
         IObservableDeploymentsClient Deployment { get; }
 
         /// <summary>
-        /// Client for GitHub's Repository Statistics API
+        /// Client for GitHub's Repository Statistics API.
+        /// Note that the GitHub API uses caching on these endpoints,
+        /// see <a href="https://developer.github.com/v3/repos/statistics/#a-word-about-caching">a word about caching</a> for more details.
         /// </summary>
         /// <remarks>
         /// See the <a href="http://developer.github.com/v3/repos/statistics/">Statistics API documentation</a> for more details
diff --git a/Octokit.Reactive/Clients/IObservableStatisticsClient.cs b/Octokit.Reactive/Clients/IObservableStatisticsClient.cs
index 16460365b9..324fc95170 100644
--- a/Octokit.Reactive/Clients/IObservableStatisticsClient.cs
+++ b/Octokit.Reactive/Clients/IObservableStatisticsClient.cs
@@ -5,6 +5,8 @@ namespace Octokit.Reactive
 {
     /// <summary>
     /// A client for GitHub's Repository Statistics API.
+    /// Note that the GitHub API uses caching on these endpoints,
+    /// see <a href="https://developer.github.com/v3/repos/statistics/#a-word-about-caching">a word about caching</a> for more details.
     /// </summary>
     /// <remarks>
     /// See the <a href="https://developer.github.com/v3/repos/statistics/">Repository Statistics API documentation</a> for more information.
diff --git a/Octokit.Reactive/Clients/ObservableRepositoriesClient.cs b/Octokit.Reactive/Clients/ObservableRepositoriesClient.cs
index e6f07b9daa..1f399145d2 100644
--- a/Octokit.Reactive/Clients/ObservableRepositoriesClient.cs
+++ b/Octokit.Reactive/Clients/ObservableRepositoriesClient.cs
@@ -315,6 +315,8 @@ public IObservable<Repository> GetAllForOrg(string organization, ApiOptions opti
 
         /// <summary>
         /// Client for GitHub's Repository Statistics API
+        /// Note that the GitHub API uses caching on these endpoints,
+        /// see <a href="https://developer.github.com/v3/repos/statistics/#a-word-about-caching">a word about caching</a> for more details.
         /// </summary>
         /// <remarks>
         /// See the <a href="http://developer.github.com/v3/repos/statistics/">Statistics API documentation</a> for more details
diff --git a/Octokit.Reactive/Clients/ObservableStatisticsClient.cs b/Octokit.Reactive/Clients/ObservableStatisticsClient.cs
index e1f3b3bf88..4f5f98b8c6 100644
--- a/Octokit.Reactive/Clients/ObservableStatisticsClient.cs
+++ b/Octokit.Reactive/Clients/ObservableStatisticsClient.cs
@@ -6,6 +6,8 @@ namespace Octokit.Reactive
 {
     /// <summary>
     /// A client for GitHub's Repository Statistics API.
+    /// Note that the GitHub API uses caching on these endpoints,
+    /// see <a href="https://developer.github.com/v3/repos/statistics/#a-word-about-caching">a word about caching</a> for more details.
     /// </summary>
     /// <remarks>
     /// See the <a href="https://developer.github.com/v3/repos/statistics/">Repository Statistics API documentation</a> for more information.
diff --git a/Octokit/Clients/IRepositoriesClient.cs b/Octokit/Clients/IRepositoriesClient.cs
index 617b93c2fb..ab9e31fb94 100644
--- a/Octokit/Clients/IRepositoriesClient.cs
+++ b/Octokit/Clients/IRepositoriesClient.cs
@@ -316,7 +316,9 @@ public interface IRepositoriesClient
         IDeploymentsClient Deployment { get; }
 
         /// <summary>
-        /// Client for GitHub's Repository Statistics API
+        /// Client for GitHub's Repository Statistics API.
+        /// Note that the GitHub API uses caching on these endpoints,
+        /// see <a href="https://developer.github.com/v3/repos/statistics/#a-word-about-caching">a word about caching</a> for more details.
         /// </summary>
         /// <remarks>
         /// See the <a href="http://developer.github.com/v3/repos/statistics/">Statistics API documentation</a> for more details
diff --git a/Octokit/Clients/IStatisticsClient.cs b/Octokit/Clients/IStatisticsClient.cs
index 9802ef752f..f7731c86d7 100644
--- a/Octokit/Clients/IStatisticsClient.cs
+++ b/Octokit/Clients/IStatisticsClient.cs
@@ -6,6 +6,8 @@ namespace Octokit
 {
     /// <summary>
     /// A client for GitHub's Repository Statistics API.
+    /// Note that the GitHub API uses caching on these endpoints,
+    /// see <a href="https://developer.github.com/v3/repos/statistics/#a-word-about-caching">a word about caching</a> for more details.
     /// </summary>
     /// <remarks>
     /// See the <a href="https://developer.github.com/v3/repos/statistics/">Repository Statistics API documentation</a> for more information.
diff --git a/Octokit/Clients/RepositoriesClient.cs b/Octokit/Clients/RepositoriesClient.cs
index b31065710e..20574b12b6 100644
--- a/Octokit/Clients/RepositoriesClient.cs
+++ b/Octokit/Clients/RepositoriesClient.cs
@@ -471,6 +471,8 @@ public Task<IReadOnlyList<Repository>> GetAllForOrg(string organization, ApiOpti
 
         /// <summary>
         /// Client for GitHub's Repository Statistics API
+        /// Note that the GitHub API uses caching on these endpoints,
+        /// see <a href="https://developer.github.com/v3/repos/statistics/#a-word-about-caching">a word about caching</a> for more details.
         /// </summary>
         /// <remarks>
         /// See the <a href="http://developer.github.com/v3/repos/statistics/">Statistics API documentation</a> for more details
diff --git a/Octokit/Clients/StatisticsClient.cs b/Octokit/Clients/StatisticsClient.cs
index 99a190778e..057e890071 100644
--- a/Octokit/Clients/StatisticsClient.cs
+++ b/Octokit/Clients/StatisticsClient.cs
@@ -7,6 +7,8 @@ namespace Octokit
 {
     /// <summary>
     /// A client for GitHub's Repository Statistics API.
+    /// Note that the GitHub API uses caching on these endpoints,
+    /// see <a href="https://developer.github.com/v3/repos/statistics/#a-word-about-caching">a word about caching</a> for more details.
     /// </summary>
     /// <remarks>
     /// See the <a href="https://developer.github.com/v3/repos/statistics/">Repository Statistics API documentation</a> for more information.