Adding to usage.md

Author: joseartrivera

GitHubComments.ps1

@@ -135,7 +135,7 @@ function Get-GitHubRepositoryComment
         If not supplied here, the DefaultNoStatus configuration property value will be used.
 
     .EXAMPLE
-        Get-GitHubReferrerTraffic -OwnerName Powershell -RepositoryName PowerShellForGitHub
+        Get-GitHubRepositoryComment -OwnerName Powershell -RepositoryName PowerShellForGitHub -Sort created -Direction asc -Since 2011-04-14T16:00:49Z
 
         Get the comments for the PowerShell\PowerShellForGitHub project.
 #>

Tests/GitHubComments.tests.ps1

@@ -83,7 +83,7 @@ Reset-GitHubConfiguration
     Set-Variable -Force -Scope Script -Option ReadOnly -Visibility Private -Name $_.Key -Value $_.Value
 }
 
-Describe 'Creating a new comment' {
+Describe 'Creating, modifying and deleting comments' {
     $repo = New-GitHubRepository -RepositoryName ([Guid]::NewGuid().Guid) -AutoInit
 
     $issue = New-GitHubIssue -Uri $repo.svn_url -Title $defaultIssueTitle

USAGE.md

@@ -30,7 +30,13 @@
         *   [Get the popular content for a repository](#get-the-popular-content-for-a-repository)
         *   [Get the number of views for a repository](#get-the-number-of-views-for-a-repository)
         *   [Get the number of clones for a repository](#get-the-number-of-clones-for-a-repository)
-
+    *   [Comments](#comments)
+        *   [Get comments from an issue](#get-comments-from-an-issue)
+        *   [Get comments from a repository](#get-comments-from-a-repository)
+        *   [Get a single comment](#get-a-single-comment)
+        *   [Adding a new comment to an issue](#adding-a-new-comment-to-an-issue)
+        *   [Editing an existing comment](#editing-an-existing-comment)
+        *   [Removing a comment](#removing-a-comment)
 ----------
 
 ## Logging
@@ -342,3 +348,35 @@ Get-GitHubViewTraffic -OwnerName PowerShell -RepositoryName PowerShellForGitHub
 ```powershell
 Get-GitHubCloneTraffic -OwnerName PowerShell -RepositoryName PowerShellForGitHub -Per 'day'
 ```
+
+### Comments
+
+#### Get comments from an issue
+```powershell
+Get-GitHubIssueComment -OwnerName Powershell -RepositoryName PowerShellForGitHub -IssueNumber 1
+```
+
+#### Get comments from a repository
+```powershell
+Get-GitHubRepositoryComment -OwnerName Powershell -RepositoryName PowerShellForGitHub -Sort created -Direction asc -Since '2011-04-14T16:00:49Z'
+```
+
+#### Get a single comment
+```powershell
+Get-GitHubComment -OwnerName Powershell -RepositoryName PowerShellForGitHub -CommentID 1
+```
+
+#### Adding a new comment to an issue
+```powershell
+New-GitHubComment -OwnerName Powershell -RepositoryName PowerShellForGitHub -IssueNumber 1 -Body "Testing this API"
+```
+
+#### Editing an existing comment
+```powershell
+Edit-GitHubComment -OwnerName Powershell -RepositoryName PowerShellForGitHub -CommentID 1 -Body "Testing this API"
+```
+
+#### Removing a comment
+```powershell
+Remove-GitHubComment -OwnerName Powershell -RepositoryName PowerShellForGitHub -CommentID 1
+```