diff --git a/lib/google/api_client/auth/storage.rb b/lib/google/api_client/auth/storage.rb
index c762316e7..e5a305231 100644
--- a/lib/google/api_client/auth/storage.rb
+++ b/lib/google/api_client/auth/storage.rb
@@ -35,7 +35,8 @@ module Google
       ##
       # Initializes the Storage object.
       #
-      # @params [Object] Storage object
+      # @param [Object] store
+      #  Storage object
       def initialize(store)
         @store= store
         @authorization = nil
@@ -44,7 +45,7 @@ module Google
       ##
       # Write the credentials to the specified store.
       #
-      # @params [Signet::OAuth2::Client] authorization
+      # @param [Signet::OAuth2::Client] authorization
       #    Optional authorization instance. If not provided, the authorization
       #    already associated with this instance will be written.
       def write_credentials(authorization=nil)
diff --git a/lib/google/api_client/auth/storages/file_store.rb b/lib/google/api_client/auth/storages/file_store.rb
index cd3eae710..b66118a13 100644
--- a/lib/google/api_client/auth/storages/file_store.rb
+++ b/lib/google/api_client/auth/storages/file_store.rb
@@ -45,9 +45,7 @@ module Google
       ##
       # Write the credentials to the specified file.
       #
-      # @param [Signet::OAuth2::Client] authorization
-      #    Optional authorization instance. If not provided, the authorization
-      #    already associated with this instance will be written.
+      # @param [Hash] credentials_hash
       def write_credentials(credentials_hash)
         open(self.path, 'w+') do |f|
           f.write(credentials_hash.to_json)
diff --git a/lib/google/api_client/auth/storages/redis_store.rb b/lib/google/api_client/auth/storages/redis_store.rb
index 3f76f7ca8..341b8f910 100644
--- a/lib/google/api_client/auth/storages/redis_store.rb
+++ b/lib/google/api_client/auth/storages/redis_store.rb
@@ -25,7 +25,10 @@ module Google
       ##
       # Initializes the RedisStore object.
       #
-      # @params [Object] Redis instance
+      # @param [Object] redis
+      #  Redis instance
+      # @param [Object] key
+      #  Optional key to store credentials under. Defaults to 'google_api_credentials'
       def initialize(redis, key = nil)
         @redis= redis
         @redis_credentials_key = key
@@ -33,6 +36,7 @@ module Google
 
       ##
       # Attempt to read in credentials from redis.
+      # @return [Hash]
       def load_credentials
         credentials = redis.get redis_credentials_key
         JSON.parse(credentials) if credentials
@@ -45,7 +49,7 @@ module Google
       ##
       # Write the credentials to redis.
       #
-      # @params [Hash] credentials
+      # @param [Hash] credentials_hash
       def write_credentials(credentials_hash)
         redis.set(redis_credentials_key, credentials_hash.to_json)
       end
diff --git a/lib/google/apis/core/base_service.rb b/lib/google/apis/core/base_service.rb
index 53aba3f04..98bf7a64d 100644
--- a/lib/google/apis/core/base_service.rb
+++ b/lib/google/apis/core/base_service.rb
@@ -164,7 +164,7 @@ module Google
         #   HTTP method as symbol (e.g. :get, :post, :put, ...)
         # @param [String] url
         #   URL to call
-        # @param [Hash<String,String] params
+        # @param [Hash<String,String>] params
         #   Optional hash of query parameters
         # @param [#read] body
         #   Optional body for POST/PUT