diff --git a/examples/prediction/README.md b/examples/prediction/README.md
index 38932da86..031ceceac 100644
--- a/examples/prediction/README.md
+++ b/examples/prediction/README.md
@@ -54,7 +54,7 @@ API. You can also set it up so the user can grant access.
 First, run the google-api script to generate access and refresh tokens. Ex.
 
     $ cd google-api-ruby-client
-    $ ruby bin/google-api oauth-2-login --scope=https://www.googleapis.com/auth/prediction --client-id=NUMBER.apps.googleusercontent.com --client-secret=CLIENT_SECRET
+    $ google-api oauth-2-login --scope=https://www.googleapis.com/auth/prediction --client-id=NUMBER.apps.googleusercontent.com --client-secret=CLIENT_SECRET
 
 Fill in your client-id and client-secret from the API Access page. You will
 probably have to set a redirect URI in your client ID
@@ -78,7 +78,7 @@ At this, point, you should have
  - Enabled your APIs Console account
  - Created a storage bucket, if required
  - Uploaded some data to Google Storage
- - Modified the script to point the 'datafile' variable to the BUCKET/OBJECT  name
+ - Modified the script to point the 'datafile' variable to the BUCKET/OBJECT name
  - Modified the script to put your credentials in, either in the code or by
    loading the generated .yaml file
  
diff --git a/tasks/gem.rake b/tasks/gem.rake
index 09130b902..3d230a34c 100644
--- a/tasks/gem.rake
+++ b/tasks/gem.rake
@@ -18,8 +18,8 @@ namespace :gem do
     s.executables << 'google-api'
 
     s.has_rdoc = true
-    s.extra_rdoc_files = %w( README )
-    s.rdoc_options.concat ['--main',  'README']
+    s.extra_rdoc_files = %w( README.md )
+    s.rdoc_options.concat ['--main',  'README.md']
 
     # Dependencies used in the main library
     s.add_runtime_dependency('signet', '~> 0.2.2')
diff --git a/tasks/rdoc.rake b/tasks/rdoc.rake
index 360e2573a..81b6076c7 100644
--- a/tasks/rdoc.rake
+++ b/tasks/rdoc.rake
@@ -8,7 +8,7 @@ namespace :doc do
     rdoc.options << '--line-numbers' << '--inline-source' <<
       '--accessor' << 'cattr_accessor=object' << '--charset' << 'utf-8'
     rdoc.template = "#{ENV['template']}.rb" if ENV['template']
-    rdoc.rdoc_files.include('README', 'CHANGELOG', 'LICENSE')
+    rdoc.rdoc_files.include('README.md', 'CHANGELOG', 'LICENSE')
     rdoc.rdoc_files.include('lib/**/*.rb')
   end
 
diff --git a/tasks/yard.rake b/tasks/yard.rake
index 991b8a628..2375cb2c9 100644
--- a/tasks/yard.rake
+++ b/tasks/yard.rake
@@ -10,7 +10,7 @@ begin
       yardoc.name = 'yard'
       yardoc.options = ['--verbose']
       yardoc.files = [
-        'lib/**/*.rb', 'ext/**/*.c', 'README', 'CHANGELOG', 'LICENSE'
+        'lib/**/*.rb', 'ext/**/*.c', 'README.md', 'CHANGELOG', 'LICENSE'
       ]
     end
   end