From 1bf7ed12894ac945724352388f6b50910c8e3bbf Mon Sep 17 00:00:00 2001
From: Burcu Dogan <jbd@google.com>
Date: Wed, 10 Sep 2014 14:48:29 -0700
Subject: [PATCH] docs: Rewording on idiomaticity explanation.

---
 docs/home.html | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/docs/home.html b/docs/home.html
index cfd05a51cdbd..4adae229ee54 100755
--- a/docs/home.html
+++ b/docs/home.html
@@ -7,7 +7,7 @@ <h1 class="logo"><img src="img/logo-full.svg" alt="Google Cloud Platform" /></h1
     <div class="container clearfix">
       <div class="col col-left">
         <h1>gcloud</h1>
-        <p><code>gcloud</code> is the Google Cloud Client Library for Node.js
+        <p>Google Cloud APIs Client for Node.js
         - an idiomatic, intuitive, and natural way for Node.js developers to
         integrate with Google Cloud Platform services, like Cloud Datastore
         and Cloud Storage.</p>
@@ -65,15 +65,17 @@ <h3 class="block-title">What is it?</h3>
         <p><code>gcloud</code> is a client library for accessing Google
         Cloud Platform services that significantly reduces the boilerplate
         code you have to write. The library provides high-level API
-        abstractions so they're easier to understand. And, it embraces
-        idioms of Node.js, such as returning Readable streams or errors
-        as the first object in callbacks. All this means you spend more
-        time creating code that matters to you.</p>
+        abstractions so they're easier to understand. It embraces
+        idioms of Node.js, works well with the standard library, and
+        integrates better with your codebase.
+        All this means you spend more time creating code that matters
+        to you.</p>
+
         <p><code>gcloud</code> is configured to access Google Cloud
         services and authorize (OAuth 2.0) automatically on your behalf.
-        With a one line install and a private key, you are up and ready
+        With a one-line install and a private key, you are up and ready
         to go. Better yet, if you are running on a Google Compute Engine
-        instance, the one line install is enough!</p>
+        instance, the one-line install is enough!</p>
 
       </div><!-- end of .col.col-left -->
 
@@ -83,12 +85,12 @@ <h4>Retrieve Datastore Entities</h4>
         <div hljs language="js">
 var gcloud = require('gcloud');
 
-var dataset = new gcloud.datastore.Dataset({
+var ds = new gcloud.datastore.Dataset({
   projectId: 'my-project',
   keyFilename: '/path/to/keyfile.json'
 });
 
-dataset.get(dataset.key('Product', 123), function(err, entity) {
+ds.get(ds.key('Product', 123), function(err, entity) {
   console.log(err, entity);
 });</div>
 
@@ -111,8 +113,9 @@ <h4>What is the relationship between <code>gcloud</code> package
       Google Cloud APIs Client for Node.js.</p>
 
       <h4>What is the relationship between the <code>gcloud</code>
-      and the <code>Google APIs Node.js Client</code>?</h4>
-      <p>The <code>Google APIs Node.js Client</code> is a client library for
+      and the Google APIs Node.js Client?</h4>
+      <p>The <a href="https://github.com/google/google-api-nodejs-client">
+      Google APIs Node.js Client</a> is a client library for
       using the broad set of Google APIs.
       <code>gcloud</code> is built specifically for the Google Cloud Platform
       and is the recommended way to integrate Google Cloud APIs into your