From 7989cca53ab1effc70466ab3fe794d70f1d18295 Mon Sep 17 00:00:00 2001
From: Ryan Gribble <ryan.gribble@gmail.com>
Date: Sat, 14 Jul 2018 19:49:56 +1000
Subject: [PATCH] tweak XmlDoc to match github documentation

---
 .../Clients/IObservableCheckRunsClient.cs             |  8 ++++----
 Octokit.Reactive/Clients/ObservableCheckRunsClient.cs |  8 ++++----
 .../Clients/CheckRunsClientTests.cs                   |  2 +-
 Octokit/Clients/CheckRunsClient.cs                    |  9 ++++-----
 Octokit/Clients/ICheckRunsClient.cs                   | 11 +++++------
 5 files changed, 18 insertions(+), 20 deletions(-)

diff --git a/Octokit.Reactive/Clients/IObservableCheckRunsClient.cs b/Octokit.Reactive/Clients/IObservableCheckRunsClient.cs
index 6ec0c8ec2e..1d8f4822fd 100644
--- a/Octokit.Reactive/Clients/IObservableCheckRunsClient.cs
+++ b/Octokit.Reactive/Clients/IObservableCheckRunsClient.cs
@@ -11,7 +11,7 @@ namespace Octokit.Reactive
     public interface IObservableCheckRunsClient
     {
         /// <summary>
-        /// Creates a new Check Run
+        /// Creates a new check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#create-a-check-run">Check Runs API documentation</a> for more information.
@@ -22,7 +22,7 @@ public interface IObservableCheckRunsClient
         IObservable<CheckRun> Create(string owner, string name, NewCheckRun newCheckRun);
 
         /// <summary>
-        /// Creates a new Check Run
+        /// Creates a new check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#create-a-check-run">Check Runs API documentation</a> for more information.
@@ -32,7 +32,7 @@ public interface IObservableCheckRunsClient
         IObservable<CheckRun> Create(long repositoryId, NewCheckRun newCheckRun);
 
         /// <summary>
-        /// Updates a Check Run
+        /// Updates a check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#update-a-check-run">Check Runs API documentation</a> for more information.
@@ -44,7 +44,7 @@ public interface IObservableCheckRunsClient
         IObservable<CheckRun> Update(string owner, string name, long checkRunId, CheckRunUpdate checkRunUpdate);
 
         /// <summary>
-        /// Updates a Check Run
+        /// Updates a check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#update-a-check-run">Check Runs API documentation</a> for more information.
diff --git a/Octokit.Reactive/Clients/ObservableCheckRunsClient.cs b/Octokit.Reactive/Clients/ObservableCheckRunsClient.cs
index e156c57595..ccc29c7081 100644
--- a/Octokit.Reactive/Clients/ObservableCheckRunsClient.cs
+++ b/Octokit.Reactive/Clients/ObservableCheckRunsClient.cs
@@ -28,7 +28,7 @@ public ObservableCheckRunsClient(IGitHubClient client)
         }
 
         /// <summary>
-        /// Creates a new Check Run
+        /// Creates a new check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#create-a-check-run">Check Runs API documentation</a> for more information.
@@ -46,7 +46,7 @@ public IObservable<CheckRun> Create(string owner, string name, NewCheckRun newCh
         }
 
         /// <summary>
-        /// Creates a new Check Run
+        /// Creates a new check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#create-a-check-run">Check Runs API documentation</a> for more information.
@@ -61,7 +61,7 @@ public IObservable<CheckRun> Create(long repositoryId, NewCheckRun newCheckRun)
         }
 
         /// <summary>
-        /// Updates a Check Run
+        /// Updates a check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#update-a-check-run">Check Runs API documentation</a> for more information.
@@ -80,7 +80,7 @@ public IObservable<CheckRun> Update(string owner, string name, long checkRunId,
         }
 
         /// <summary>
-        /// Updates a Check Run
+        /// Updates a check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#update-a-check-run">Check Runs API documentation</a> for more information.
diff --git a/Octokit.Tests.Integration/Clients/CheckRunsClientTests.cs b/Octokit.Tests.Integration/Clients/CheckRunsClientTests.cs
index 06ae17cd5e..cedbd16b54 100644
--- a/Octokit.Tests.Integration/Clients/CheckRunsClientTests.cs
+++ b/Octokit.Tests.Integration/Clients/CheckRunsClientTests.cs
@@ -259,7 +259,7 @@ public async Task GetsAllCheckRuns()
                         CheckName = "name",
                         Status = CheckStatusFilter.InProgress
                     };
-                    
+
                     var checkRuns = await _githubAppInstallation.Check.Run.GetAllForCheckSuite(repoContext.RepositoryOwner, repoContext.RepositoryName, created.CheckSuite.Id, request);
 
                     // Check result
diff --git a/Octokit/Clients/CheckRunsClient.cs b/Octokit/Clients/CheckRunsClient.cs
index 593ee24fdc..dd62b8c093 100644
--- a/Octokit/Clients/CheckRunsClient.cs
+++ b/Octokit/Clients/CheckRunsClient.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
 
@@ -22,7 +21,7 @@ public CheckRunsClient(IApiConnection apiConnection) : base(apiConnection)
         }
 
         /// <summary>
-        /// Creates a new Check Run
+        /// Creates a new check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#create-a-check-run">Check Runs API documentation</a> for more information.
@@ -40,7 +39,7 @@ public Task<CheckRun> Create(string owner, string name, NewCheckRun newCheckRun)
         }
 
         /// <summary>
-        /// Creates a new Check Run
+        /// Creates a new check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#create-a-check-run">Check Runs API documentation</a> for more information.
@@ -55,7 +54,7 @@ public Task<CheckRun> Create(long repositoryId, NewCheckRun newCheckRun)
         }
 
         /// <summary>
-        /// Updates a Check Run
+        /// Updates a check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#update-a-check-run">Check Runs API documentation</a> for more information.
@@ -74,7 +73,7 @@ public Task<CheckRun> Update(string owner, string name, long checkRunId, CheckRu
         }
 
         /// <summary>
-        /// Updates a Check Run
+        /// Updates a check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#update-a-check-run">Check Runs API documentation</a> for more information.
diff --git a/Octokit/Clients/ICheckRunsClient.cs b/Octokit/Clients/ICheckRunsClient.cs
index 92494bfa14..253e1fa0dc 100644
--- a/Octokit/Clients/ICheckRunsClient.cs
+++ b/Octokit/Clients/ICheckRunsClient.cs
@@ -1,5 +1,4 @@
-using System.Collections.Generic;
-using System.Threading.Tasks;
+using System.Threading.Tasks;
 
 namespace Octokit
 {
@@ -12,7 +11,7 @@ namespace Octokit
     public interface ICheckRunsClient
     {
         /// <summary>
-        /// Creates a new Check Run
+        /// Creates a new check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#create-a-check-run">Check Runs API documentation</a> for more information.
@@ -23,7 +22,7 @@ public interface ICheckRunsClient
         Task<CheckRun> Create(string owner, string name, NewCheckRun newCheckRun);
 
         /// <summary>
-        /// Creates a new Check Run
+        /// Creates a new check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#create-a-check-run">Check Runs API documentation</a> for more information.
@@ -33,7 +32,7 @@ public interface ICheckRunsClient
         Task<CheckRun> Create(long repositoryId, NewCheckRun newCheckRun);
 
         /// <summary>
-        /// Updates a Check Run
+        /// Updates a check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#update-a-check-run">Check Runs API documentation</a> for more information.
@@ -45,7 +44,7 @@ public interface ICheckRunsClient
         Task<CheckRun> Update(string owner, string name, long checkRunId, CheckRunUpdate checkRunUpdate);
 
         /// <summary>
-        /// Updates a Check Run
+        /// Updates a check run for a specific commit in a repository.
         /// </summary>
         /// <remarks>
         /// See the <a href="https://developer.github.com/v3/checks/runs/#update-a-check-run">Check Runs API documentation</a> for more information.