added some more docs

Octokit/Clients/ActivitiesClient.cs

@@ -21,9 +21,21 @@
             Feeds = new FeedsClient(apiConnection);
         }
 
+        /// <summary>
+        /// Client for the Events API
+        /// </summary>
         public IEventsClient Events { get; private set; }
+        /// <summary>
+        /// Client for the Starring API
+        /// </summary>
         public IStarredClient Starring { get; private set; }
+        /// <summary>
+        /// Client for the Watching API
+        /// </summary>
         public IWatchedClient Watching { get; private set; }
+        /// <summary>
+        /// Client for the Feeds API
+        /// </summary>
         public IFeedsClient Feeds { get; private set; }
     }
 }

Octokit/Clients/IActivitiesClient.cs

@@ -8,9 +8,24 @@
     /// </remarks>
     public interface IActivitiesClient
     {
+        /// <summary>
+        /// Client for the Events API
+        /// </summary>
         IEventsClient Events { get; }
+
+        /// <summary>
+        /// Client for the Starring API
+        /// </summary>
         IStarredClient Starring { get; }
+
+        /// <summary>
+        /// Client for the Watching API
+        /// </summary>
         IWatchedClient Watching { get; }
+
+        /// <summary>
+        /// Client for the Feeds API
+        /// </summary>
         IFeedsClient Feeds { get; }
     }
 }

Octokit/Clients/IPullRequestReviewCommentsClient.cs

@@ -3,6 +3,12 @@ using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Pull Request Review Comments API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/pulls/comments/">Review Comments API documentation</a> for more information.
+    /// </remarks>
     public interface IPullRequestReviewCommentsClient
     {
         /// <summary>

Octokit/Clients/IRepositoryCommitsClient.cs

@@ -4,6 +4,12 @@ using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Repository Commits API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="http://developer.github.com/v3/repos/commits/">Repository Commits API documentation</a> for more information.
+    /// </remarks>
     public interface IRepositoryCommitsClient
     {
         /// <summary>

Octokit/Clients/IRepositoryDeployKeysClient.cs

@@ -1,12 +1,15 @@
-using System;
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
-using System.Linq;
-using System.Text;
 using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Repository Deploy Keys API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/repos/keys/">Deploy Keys API documentation</a> for more information.
+    /// </remarks>
     public interface IRepositoryDeployKeysClient
     {
         /// <summary>

Octokit/Clients/ISearchClient.cs

@@ -3,8 +3,11 @@
 namespace Octokit
 {
     /// <summary>
-    /// GitHub Search Api Client
+    /// A client for GitHub's Search API.
     /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/search/">Search API documentation</a> for more information.
+    /// </remarks>
     public interface ISearchClient
     {
         /// <summary>

Octokit/Clients/IStatisticsClient.cs

@@ -4,6 +4,12 @@ using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Repository Statistics API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/repos/statistics/">Repository Statistics API documentation</a> for more information.
+    /// </remarks>
     public interface IStatisticsClient
     {
         /// <summary>

Octokit/Clients/IWatchedClient.cs

@@ -4,6 +4,12 @@ using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Watching API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/activity/watching/">Watching API documentation</a> for more information.
+    /// </remarks>
     public interface IWatchedClient
     {
         /// <summary>

Octokit/Clients/PullRequestReviewCommentsClient.cs

@@ -4,6 +4,12 @@ using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Pull Request Review Comments API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/pulls/comments/">Review Comments API documentation</a> for more information.
+    /// </remarks>
     public class PullRequestReviewCommentsClient : ApiClient, IPullRequestReviewCommentsClient
     {
         public PullRequestReviewCommentsClient(IApiConnection apiConnection)

Octokit/Clients/RepositoryCommitsClient.cs

@@ -3,6 +3,12 @@ using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Repository Commits API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="http://developer.github.com/v3/repos/commits/">Repository Commits API documentation</a> for more information.
+    /// </remarks>
     public class RepositoryCommitsClient : IRepositoryCommitsClient
     {
         readonly IApiConnection _apiConnection;

Octokit/Clients/RepositoryDeployKeysClient.cs

@@ -7,10 +7,10 @@ using System.Threading.Tasks;
 namespace Octokit
 {
     /// <summary>
-    /// A client for GitHub's repository deploy keys API.
+    /// A client for GitHub's Repository Deploy Keys API.
     /// </summary>
     /// <remarks>
-    /// See the <a href="https://developer.github.com/v3/repos/keys/">Repository deploy keys API documentation</a> for more information.
+    /// See the <a href="https://developer.github.com/v3/repos/keys/">Deploy Keys API documentation</a> for more information.
     /// </remarks>
     public class RepositoryDeployKeysClient : ApiClient, IRepositoryDeployKeysClient
     {

Octokit/Clients/SearchClient.cs

@@ -3,8 +3,11 @@
 namespace Octokit
 {
     /// <summary>
-    /// GitHub Search Api Client
+    /// A client for GitHub's Search API.
     /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/search/">Search API documentation</a> for more information.
+    /// </remarks>
     public class SearchClient : ApiClient, ISearchClient
     {
         /// <summary>

Octokit/Clients/StatisticsClient.cs

@@ -4,6 +4,12 @@ using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Repository Statistics API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/repos/statistics/">Repository Statistics API documentation</a> for more information.
+    /// </remarks>
     public class StatisticsClient : ApiClient, IStatisticsClient
     {
         /// <summary>

Octokit/Clients/WatchedClient.cs

@@ -4,6 +4,12 @@ using System.Threading.Tasks;
 
 namespace Octokit
 {
+    /// <summary>
+    /// A client for GitHub's Watching API.
+    /// </summary>
+    /// <remarks>
+    /// See the <a href="https://developer.github.com/v3/activity/watching/">Watching API documentation</a> for more information.
+    /// </remarks>
     public class WatchedClient : ApiClient, IWatchedClient
     {
          /// <summary>