From 75d1256c7b52bceabda9687a7d02c5511ee4452d Mon Sep 17 00:00:00 2001 From: Burcu Dogan Date: Tue, 9 Sep 2014 14:15:01 -0700 Subject: [PATCH 1/6] Minor tweaks on the homepage. --- docs/home.html | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/home.html b/docs/home.html index 9337f32e35c..3642fa6e24c 100755 --- a/docs/home.html +++ b/docs/home.html @@ -7,7 +7,7 @@

Google Cloud Platform

gcloud

-

gcloud-node is the Google Cloud Client Library 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.

+

gcloud is the Google Cloud Client Library 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.

@@ -59,8 +59,8 @@

One-line npm install

What is it?

-

gcloud-node is a client library for accessing Google Cloud Platform services that significantly reduces the boilerplate code you have to write. The library is 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.

-

gcloud-node is configured to access Google Cloud services and authorize (OAuth2) automatically on your behalf. 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!

+

gcloud is a client library for accessing Google Cloud Platform services that significantly reduces the boilerplate code you have to write. The library is 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.

+

gcloud 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 to go. Better yet, if you are running on a Google Compute Engine instance, the one line install is enough!

@@ -76,7 +76,7 @@

Retrieve Datastore Entities

}); dataset.get(dataset.key('Product', 123), function(err, entity) { - console.log(err || entity); + console.log(err, entity); });
@@ -86,13 +86,14 @@

Retrieve Datastore Entities

FAQ

- +

What is the relationship between gcloud-node and the gcloud commandline tool?

Both the gcloud commandline tool and gcloud-node are part of the Google Cloud SDK: a collection of tools and libraries that enable you to easily create and manage resources on Google Cloud Platform. The gcloud commandline tool can be used to manage both your development workflow and your Google Cloud Platform resources while gcloud-node is the Google Cloud Client Library for Node.js.

- +

What is the relationship between gcloud-node and the Google APIs NodeJS Client?

-

The Google APIs NodeJS Client is a client library for using the broad set of Google APIs. gcloud-node is built specifically for the Google Cloud Platform and is the recommended way to integrate Google Cloud APIs into your Node.js applications. If your application requires both Google Cloud and other Google APIs, the 2 libraries may be used by your application.

- +

The Google APIs Node.js Client is a client library for using the broad set of Google APIs. + gcloud is built specifically for the Google Cloud Platform and is the recommended way to integrate Google Cloud APIs into your Node.js applications. If your application requires both Google Cloud and other Google APIs, the 2 libraries may be used by your application.

+
From 63688e3d2f2ce9e81b3590651c3eb22f4fe280fb Mon Sep 17 00:00:00 2001 From: Burcu Dogan Date: Tue, 9 Sep 2014 14:18:46 -0700 Subject: [PATCH 2/6] Enforce 80-col limit on text. --- docs/home.html | 41 +++++++++++++++++++++++++++++++++-------- 1 file changed, 33 insertions(+), 8 deletions(-) diff --git a/docs/home.html b/docs/home.html index 3642fa6e24c..de736c8c534 100755 --- a/docs/home.html +++ b/docs/home.html @@ -7,7 +7,10 @@

Google Cloud Platform

gcloud

-

gcloud is the Google Cloud Client Library 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.

+

gcloud is the Google Cloud Client Library 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.

@@ -59,8 +62,18 @@

One-line npm install

What is it?

-

gcloud is a client library for accessing Google Cloud Platform services that significantly reduces the boilerplate code you have to write. The library is 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.

-

gcloud 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 to go. Better yet, if you are running on a Google Compute Engine instance, the one line install is enough!

+

gcloud is a client library for accessing Google + Cloud Platform services that significantly reduces the boilerplate + code you have to write. The library is 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.

+

gcloud 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 + to go. Better yet, if you are running on a Google Compute Engine + instance, the one line install is enough!

@@ -87,12 +100,24 @@

Retrieve Datastore Entities

FAQ

-

What is the relationship between gcloud-node and the gcloud commandline tool?

-

Both the gcloud commandline tool and gcloud-node are part of the Google Cloud SDK: a collection of tools and libraries that enable you to easily create and manage resources on Google Cloud Platform. The gcloud commandline tool can be used to manage both your development workflow and your Google Cloud Platform resources while gcloud-node is the Google Cloud Client Library for Node.js.

+

What is the relationship between gcloud-node + and the gcloud commandline tool?

+

Both the gcloud commandline tool and + gcloud-node are part of the Google Cloud SDK: a collection + of tools and libraries that enable you to easily create and manage + resources on Google Cloud Platform. The gcloud commandline + tool can be used to manage both your development workflow and your + Google Cloud Platform resources while gcloud-node is the + Google Cloud Client Library for Node.js.

-

What is the relationship between gcloud-node and the Google APIs NodeJS Client?

-

The Google APIs Node.js Client is a client library for using the broad set of Google APIs. - gcloud is built specifically for the Google Cloud Platform and is the recommended way to integrate Google Cloud APIs into your Node.js applications. If your application requires both Google Cloud and other Google APIs, the 2 libraries may be used by your application.

+

What is the relationship between gcloud-node + and the Google APIs NodeJS Client?

+

The Google APIs Node.js Client is a client library for + using the broad set of Google APIs. + gcloud is built specifically for the Google Cloud Platform + and is the recommended way to integrate Google Cloud APIs into your + Node.js applications. If your application requires both Google Cloud and + other Google APIs, the 2 libraries may be used by your application.

From 879ea3c6c596b6c11ece41a72dd7602a9af42d7a Mon Sep 17 00:00:00 2001 From: Burcu Dogan Date: Tue, 9 Sep 2014 14:34:13 -0700 Subject: [PATCH 3/6] Use "gcloud package" when talking about the gcloud nom package. --- docs/home.html | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/home.html b/docs/home.html index de736c8c534..1bab34166c6 100755 --- a/docs/home.html +++ b/docs/home.html @@ -100,18 +100,18 @@

Retrieve Datastore Entities

FAQ

-

What is the relationship between gcloud-node +

What is the relationship between gcloud package and the gcloud commandline tool?

Both the gcloud commandline tool and - gcloud-node are part of the Google Cloud SDK: a collection + gcloud package is a part of the Google Cloud SDK: a collection of tools and libraries that enable you to easily create and manage resources on Google Cloud Platform. The gcloud commandline tool can be used to manage both your development workflow and your - Google Cloud Platform resources while gcloud-node is the + Google Cloud Platform resources while gcloud package is the Google Cloud Client Library for Node.js.

-

What is the relationship between gcloud-node - and the Google APIs NodeJS Client?

+

What is the relationship between gcloud + and the Google APIs Node.js Client?

The Google APIs Node.js Client is a client library for using the broad set of Google APIs. gcloud is built specifically for the Google Cloud Platform From c0ea78f3cba23d8820d4b8cf97446f427a187126 Mon Sep 17 00:00:00 2001 From: Burcu Dogan Date: Wed, 10 Sep 2014 13:20:09 -0700 Subject: [PATCH 4/6] docs: Minor wording corrections for the homepage. --- docs/home.html | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/home.html b/docs/home.html index 1bab34166c6..cfd05a51cdb 100755 --- a/docs/home.html +++ b/docs/home.html @@ -64,7 +64,7 @@

What is it?

gcloud is a client library for accessing Google Cloud Platform services that significantly reduces the boilerplate - code you have to write. The library is provides high-level API + 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 @@ -98,21 +98,21 @@

Retrieve Datastore Entities

-

FAQ

+

FAQ

-

What is the relationship between gcloud package - and the gcloud commandline tool?

-

Both the gcloud commandline tool and +

What is the relationship between gcloud package + and the gcloud command-line tool?

+

Both the gcloud command-line tool and gcloud package is a part of the Google Cloud SDK: a collection of tools and libraries that enable you to easily create and manage - resources on Google Cloud Platform. The gcloud commandline + resources on Google Cloud Platform. The gcloud command-line tool can be used to manage both your development workflow and your - Google Cloud Platform resources while gcloud package is the - Google Cloud Client Library for Node.js.

+ Google Cloud Platform resources while the gcloud package is the + Google Cloud APIs Client for Node.js.

-

What is the relationship between gcloud +

What is the relationship between the gcloud and the Google APIs Node.js Client?

-

The Google APIs Node.js Client is a client library for +

The Google APIs Node.js Client is a client library for using the broad set of Google APIs. gcloud is built specifically for the Google Cloud Platform and is the recommended way to integrate Google Cloud APIs into your From 681c7ce2b8a6785173da642fe529247d235c1b4f Mon Sep 17 00:00:00 2001 From: Burcu Dogan Date: Wed, 10 Sep 2014 14:48:29 -0700 Subject: [PATCH 5/6] docs: Rewording on idiomaticity explanation. --- docs/home.html | 29 ++++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/docs/home.html b/docs/home.html index cfd05a51cdb..92073cfca06 100755 --- a/docs/home.html +++ b/docs/home.html @@ -7,7 +7,7 @@

Google Cloud Platform

gcloud

-

gcloud is the Google Cloud Client Library for Node.js +

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.

@@ -65,15 +65,17 @@

What is it?

gcloud 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.

+ 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.

+

gcloud 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!

+ instance, the one-line install is enough!

@@ -83,12 +85,12 @@

Retrieve Datastore Entities

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); });
@@ -100,7 +102,7 @@

Retrieve Datastore Entities

FAQ

-

What is the relationship between gcloud package +

What is the relationship gcloud package and the gcloud command-line tool?

Both the gcloud command-line tool and gcloud package is a part of the Google Cloud SDK: a collection @@ -110,9 +112,10 @@

What is the relationship between gcloud package Google Cloud Platform resources while the gcloud package is the Google Cloud APIs Client for Node.js.

-

What is the relationship between the gcloud - and the Google APIs Node.js Client?

-

The Google APIs Node.js Client is a client library for +

What is the relationship between gcloud + and the Google APIs Node.js Client?

+

The + Google APIs Node.js Client is a client library for using the broad set of Google APIs. gcloud is built specifically for the Google Cloud Platform and is the recommended way to integrate Google Cloud APIs into your From fd0b9f0f881a19ebe929550acb5cb3b5a069586c Mon Sep 17 00:00:00 2001 From: Burcu Dogan Date: Wed, 10 Sep 2014 15:10:02 -0700 Subject: [PATCH 6/6] docs: Fixing the official name, minor grammatical fixes. --- docs/home.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/home.html b/docs/home.html index 92073cfca06..8c17653abac 100755 --- a/docs/home.html +++ b/docs/home.html @@ -7,7 +7,7 @@

Google Cloud Platform

gcloud

-

Google Cloud APIs Client for Node.js +

Google Cloud Client Library 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.

@@ -105,12 +105,12 @@

FAQ

What is the relationship gcloud package and the gcloud command-line tool?

Both the gcloud command-line tool and - gcloud package is a part of the Google Cloud SDK: a collection + gcloud package are a part of the Google Cloud SDK: a collection of tools and libraries that enable you to easily create and manage - resources on Google Cloud Platform. The gcloud command-line + resources on the Google Cloud Platform. The gcloud command-line tool can be used to manage both your development workflow and your Google Cloud Platform resources while the gcloud package is the - Google Cloud APIs Client for Node.js.

+ Google Cloud Client Library for Node.js.

What is the relationship between gcloud and the Google APIs Node.js Client?