diff --git a/Octokit/Models/Request/NewPullRequest.cs b/Octokit/Models/Request/NewPullRequest.cs
index 7584bacb..e2e799e8 100644
--- a/Octokit/Models/Request/NewPullRequest.cs
+++ b/Octokit/Models/Request/NewPullRequest.cs
@@ -24,7 +24,5 @@ namespace Octokit
         /// Whether the pull request is open or closed. The default is <see cref="ItemState.Open"/>.
         /// </summary>
         public ItemState State { get; set; }
-
-
     }
 }
diff --git a/Octokit/Models/Request/PullRequestRequest.cs b/Octokit/Models/Request/PullRequestRequest.cs
index b2cd893c..f4581f7d 100644
--- a/Octokit/Models/Request/PullRequestRequest.cs
+++ b/Octokit/Models/Request/PullRequestRequest.cs
@@ -9,12 +9,19 @@ namespace Octokit
             State = ItemState.Open;
         }
 
+        /// <summary>
+        /// "open" or "closed" to filter by state. Default is "open".
+        /// </summary>
         public ItemState State { get; set; }
 
-        [Parameter(Key = "head")]
+        /// <summary>
+        /// Filter pulls by head user and branch name in the format of "user:ref-name".
+        /// </summary>
         public string Head { get; set; }
 
-        [Parameter(Key = "base")]
+        /// <summary>
+        /// Filter pulls by base branch name.
+        /// </summary>
         public string Base { get; set; }
     }
 }
diff --git a/Octokit/Models/Response/PullRequest.cs b/Octokit/Models/Response/PullRequest.cs
index ed977d41..d9a2dd95 100644
--- a/Octokit/Models/Response/PullRequest.cs
+++ b/Octokit/Models/Response/PullRequest.cs
@@ -14,8 +14,19 @@ namespace Octokit
         /// </summary>
         public int Number { get; set; }
 
+        /// <summary>
+        /// The URL for the pull request page.
+        /// </summary>
         public Uri HtmlUrl { get; set; }
+
+        /// <summary>
+        /// The URL for the pull request's diff (.diff) file.
+        /// </summary>
         public Uri DiffUrl { get; set; }
+
+        /// <summary>
+        /// The URL for the pull request's patch (.patch) file.
+        /// </summary>
         public Uri PatchUrl { get; set; }
     }
 }
\ No newline at end of file