From a607a75c310ddd8c25c92197a82ac8be48c30a6e Mon Sep 17 00:00:00 2001 From: Jonathan Beri Date: Thu, 4 Sep 2014 21:15:31 -0700 Subject: [PATCH 1/4] Hero description for the landing page --- docs/home.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/home.html b/docs/home.html index c61b75938b8..09cbaedd82a 100755 --- a/docs/home.html +++ b/docs/home.html @@ -7,7 +7,7 @@

Google Cloud Platform

gcloud

-

Node idiomatic client for Google Cloud services.

+

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.

From a2509c3dfece4b28ef90f80de5f849618c59f0f3 Mon Sep 17 00:00:00 2001 From: Jonathan Beri Date: Thu, 4 Sep 2014 21:24:42 -0700 Subject: [PATCH 2/4] Draft of What Is It for the landing page Marc took a pass on it but still needs a final revision --- docs/home.html | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/home.html b/docs/home.html index 09cbaedd82a..c2d5110d804 100755 --- a/docs/home.html +++ b/docs/home.html @@ -59,7 +59,9 @@

One-line npm install

What is it?

-

Node idiomatic client for Google Cloud services.

+

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!

+
From f29bc84a5c6524924995e8411da3c9c7fc5c5b62 Mon Sep 17 00:00:00 2001 From: Jonathan Beri Date: Thu, 4 Sep 2014 21:26:49 -0700 Subject: [PATCH 3/4] Updated snippet for landing page --- docs/home.html | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/home.html b/docs/home.html index c2d5110d804..4bebb663926 100755 --- a/docs/home.html +++ b/docs/home.html @@ -65,16 +65,19 @@

What is it?

-

Sample code

+

Retrieve Datastore Entities

var gcloud = require('gcloud'); -var datastore = gcloud.datastore; -// new datastore.Dataset(); +var dataset = new gcloud.datastore.Dataset({ + projectId: 'my-project', + keyFilename: '/path/to/keyfile.json' +}); -var storage = gcloud.storage; -// new storage.Bucket();
+dataset.get(dataset.key('Product', 123), function(err, entity) { + console.log(err || entity); +});
From 25df2f8e9b31526a9b6a7c5c0a91b1659767857a Mon Sep 17 00:00:00 2001 From: Jonathan Beri Date: Thu, 4 Sep 2014 21:27:30 -0700 Subject: [PATCH 4/4] Added FAQ to landing page --- docs/home.html | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/home.html b/docs/home.html index 4bebb663926..bcb143fbcc4 100755 --- a/docs/home.html +++ b/docs/home.html @@ -83,4 +83,16 @@

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.

+ +
+