diff --git a/github/authorizations.go b/github/authorizations.go
index 58fcc4e..35ce9a9 100644
--- a/github/authorizations.go
+++ b/github/authorizations.go
@@ -398,7 +398,7 @@ func (s *AuthorizationsService) DeleteGrant(id int) (*Response, error) {
 	return s.client.Do(req, nil)
 }
 
-// Create an impersonation OAuth token.
+// CreateImpersonation creates an impersonation OAuth token.
 //
 // This requires admin permissions. With the returned Authorization.Token
 // you can e.g. create or delete a user's public SSH key. NOTE: creating a
@@ -420,7 +420,7 @@ func (s *AuthorizationsService) CreateImpersonation(username string, authReq *Au
 	return a, resp, err
 }
 
-// Delete an impersonation OAuth token.
+// DeleteImpersonation deletes an impersonation OAuth token.
 //
 // NOTE: there can be only one at a time.
 //
diff --git a/github/event_types.go b/github/event_types.go
index f3e163d..20f509a 100644
--- a/github/event_types.go
+++ b/github/event_types.go
@@ -123,8 +123,9 @@ type GollumEvent struct {
 	Sender *User       `json:"sender,omitempty"`
 }
 
-// DEPRECATED: IssueActivityEvent represents the payload delivered by Issue webhook
-// Use IssuesEvent instead.
+// IssueActivityEvent represents the payload delivered by Issue webhook.
+//
+// Deprecated: Use IssuesEvent instead.
 type IssueActivityEvent struct {
 	Action *string `json:"action,omitempty"`
 	Issue  *Issue  `json:"issue,omitempty"`
diff --git a/github/github.go b/github/github.go
index 591bc54..a64d76c 100644
--- a/github/github.go
+++ b/github/github.go
@@ -638,6 +638,8 @@ func category(path string) rateLimitCategory {
 	}
 }
 
+// RateLimit returns the core rate limit for the current client.
+//
 // Deprecated: RateLimit is deprecated, use RateLimits instead.
 func (c *Client) RateLimit() (*Rate, *Response, error) {
 	limits, resp, err := c.RateLimits()
diff --git a/github/migrations_source_import.go b/github/migrations_source_import.go
index 6ed4acf..44505fa 100644
--- a/github/migrations_source_import.go
+++ b/github/migrations_source_import.go
@@ -163,7 +163,7 @@ func (s *MigrationService) StartImport(owner, repo string, in *Import) (*Import,
 	return out, resp, err
 }
 
-// QueryImport queries for the status and progress of an ongoing repository import.
+// ImportProgress queries for the status and progress of an ongoing repository import.
 //
 // GitHub API docs: https://developer.github.com/v3/migration/source_imports/#get-import-progress
 func (s *MigrationService) ImportProgress(owner, repo string) (*Import, *Response, error) {