diff --git a/Octokit/Models/Request/BranchProtectionUpdate.cs b/Octokit/Models/Request/BranchProtectionUpdate.cs
index 0dfca599..76ca4465 100644
--- a/Octokit/Models/Request/BranchProtectionUpdate.cs
+++ b/Octokit/Models/Request/BranchProtectionUpdate.cs
@@ -9,6 +9,9 @@ namespace Octokit
     /// <summary>
     /// Specifies the requested settings for branch protection
     /// </summary>
+    /// <remarks>
+    /// Note: this is a PREVIEW api: https://developer.github.com/changes/2016-06-27-protected-branches-api-update/
+    /// </remarks>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public class BranchProtectionSettingsUpdate
     {
diff --git a/Octokit/Models/Request/BranchUpdate.cs b/Octokit/Models/Request/BranchUpdate.cs
index 7afca66a..554a7205 100644
--- a/Octokit/Models/Request/BranchUpdate.cs
+++ b/Octokit/Models/Request/BranchUpdate.cs
@@ -6,8 +6,10 @@ namespace Octokit
 {
     /// <summary>
     /// Specifies the values used to update a <see cref="Branch"/>.
-    /// Note: this is a PREVIEW api: https://developer.github.com/changes/2015-11-11-protected-branches-api/
     /// </summary>
+    /// <remarks>
+    /// Note: this is a PREVIEW api: https://developer.github.com/changes/2015-11-11-protected-branches-api/
+    /// </remarks>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     [Obsolete("BranchProtection preview functionality in the GitHub API has had breaking changes.  This existing implementation will cease to work when the preview period ends.")]
     public class BranchUpdate
diff --git a/Octokit/Models/Response/Branch.cs b/Octokit/Models/Response/Branch.cs
index 3054c412..43206822 100644
--- a/Octokit/Models/Response/Branch.cs
+++ b/Octokit/Models/Response/Branch.cs
@@ -38,7 +38,6 @@ namespace Octokit
 
         /// <summary>
         /// The <see cref="BranchProtection"/> details for this <see cref="Branch"/>.
-        /// Note: this is a PREVIEW api: https://developer.github.com/changes/2015-11-11-protected-branches-api/
         /// </summary>
         [Obsolete("BranchProtection preview functionality in the GitHub API has had breaking changes.  This existing implementation will cease to work when the preview period ends.", false)]
         public BranchProtection Protection { get; protected set; }
diff --git a/Octokit/Models/Response/BranchProtection.cs b/Octokit/Models/Response/BranchProtection.cs
index d7f64fdc..98225ae6 100644
--- a/Octokit/Models/Response/BranchProtection.cs
+++ b/Octokit/Models/Response/BranchProtection.cs
@@ -9,8 +9,10 @@ namespace Octokit
 {
     /// <summary>
     /// Protection details for a <see cref="Branch"/>.
-    /// Note: this is a PREVIEW api: https://developer.github.com/changes/2015-11-11-protected-branches-api/
     /// </summary>
+    /// <remarks>
+    /// Note: this is a PREVIEW api: https://developer.github.com/changes/2015-11-11-protected-branches-api/
+    /// </remarks>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     [Obsolete("BranchProtection preview functionality in the GitHub API has had breaking changes.  This existing implementation will cease to work when the preview period ends.")]
     public class BranchProtection
@@ -97,8 +99,10 @@ namespace Octokit
 
     /// <summary>
     /// Protection details for a <see cref="Branch"/>.
-    /// Note: this is a PREVIEW api: https://developer.github.com/changes/2016-06-27-protected-branches-api-update/
     /// </summary>
+    /// <remarks>
+    /// Note: this is a PREVIEW api: https://developer.github.com/changes/2016-06-27-protected-branches-api-update/
+    /// </remarks>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public class BranchProtectionSettings
     {