Re-organized readme files.

Author: jmdobry

README.md

@@ -48,4 +48,146 @@ create a project/app id. (App id and project id are identical.)
 
         gcloud preview app deploy
 
-1. Awesome! Your application is now live at `your-app-id.appspot.com`.
+1. Awesome! Your application is now live at `your-project-id.appspot.com`.
+
+
+## Samples
+__Google (Cloud) Products__
+
+- Google Analytics - [Source code][aeanalytics_1]
+- Google Cloud Logging - [Source code][aelogging_1]
+- Google Cloud Pub/Sub - [Source code][aepubsub_1]
+- Google Cloud Storage - [Source code][aestorage_1]
+
+__Frameworks__
+
+- Express.js - [Source code][express_1] | [App Engine Tutorial][express_2] | [Live demo][express_3] | [Documentation][express_4]
+  - Express.js + Memcached Sessions - [Source code][express_5] | [Documentation][express_6]
+- Geddy.js - [Source code][geddy_1] | [App Engine Tutorial][geddy_2] | [Live demo][geddy_3] | [Documentation][geddy_4]
+- Hapi.js - [Source code][hapi_1] | [App Engine Tutorial][hapi_2] | [Live demo][hapi_3] | [Documentation][hapi_4]
+- Loopback.js - [Source code][loopback_1] | [App Engine Tutorial][loopback_2] | [Live demo][loopback_3] | [Documentation][loopback_4]
+- Koa.js - [Source code][koa_1] | [App Engine Tutorial][koa_2] | [Live demo][koa_3] | [Documentation][koa_4]
+- Kraken.js - [Source code][kraken_1] | [App Engine Tutorial][kraken_2] | [Live demo][kraken_3] | [Documentation][kraken_4]
+- Parse-server - [Source code][parse_1]
+- Restify.js - [Source code][restify_1] | [App Engine Tutorial][restify_2] | [Live demo][restify_3] | [Documentation][restify_4]
+- Sails.js - [Source code][sails_1] | [App Engine Tutorial][sails_2] | [Live demo][sails_3] | [Documentation][sails_4]
+
+__Databases__
+
+- Google Cloud Datastore - [Source code][aedatastore_1]
+- Google Cloud SQL - [Source code][aecloudsql_1]
+- Memcached - [Source code][memcached_1]
+- MongoDB - [Source code][mongodb_1] | [App Engine Tutorial][mongodb_2] | [Documentation][mongodb_3]
+- Redis - [Source code][redis_1] | [App Engine Tutorial][redis_2] | [Documentation][redis_3]
+
+__Tools__
+
+- gcloud-node - [Source code][gcloud_1] | [Documentation][gcloud_2]
+- Bower - [Source code][bower_1] | [App Engine Tutorial][bower_2] | [Documentation][bower_3]
+- Grunt - [Source code][grunt_1] | [App Engine Tutorial][grunt_2] | [Live demo][grunt_3] | [Documentation][grunt_4]
+- Mailgun - [Source code][mailgun_1] | [App Engine Tutorial][mailgun_2] | [Documentation][mailgun_3]
+- Sendgrid - [Source code][sendgrid_1] | [App Engine Tutorial][sendgrid_2] | [Documentation][sendgrid_3]
+- Twilio - [Source code][twilio_1]
+- Webpack - [Source code][webpack_1] | [App Engine Tutorial][webpack_2] | [Documentation][webpack_3]
+- WebSockets - [Source code][websockets_1]
+
+__Other Examples__
+
+- Express.js Hello World - [Source code][expresshw_1]
+- Extending the runtime - [Source code][aeextending_1]
+- Reading/writing from/to disk - [Source code][aedisk_1]
+- Serving static files - [Source code][aestaticfiles_1]
+
+[aeanalytics_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/analytics
+[aelogging_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/logging
+[aepubsub_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/pubsub
+[aestorage_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/storage
+
+[express_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/express
+[express_2]: https://cloud.google.com/nodejs/resources/frameworks/express
+[express_3]: http://express-dot-nodejs-docs-samples.appspot.com
+[express_4]: http://expressjs.com/
+[express_5]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/express-memcached-session
+[express_6]: https://github.com/balor/connect-memcached
+
+[geddy_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/geddy
+[geddy_2]: https://cloud.google.com/nodejs/resources/frameworks/geddy
+[geddy_3]: http://geddy-dot-nodejs-docs-samples.appspot.com
+[geddy_4]: http://geddyjs.org/
+
+[hapi_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/hapi
+[hapi_2]: https://cloud.google.com/nodejs/resources/frameworks/hapi
+[hapi_3]: http://hapi-dot-nodejs-docs-samples.appspot.com
+[hapi_4]: http://hapijs.com/
+
+[loopback_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/loopback
+[loopback_2]: https://cloud.google.com/nodejs/resources/frameworks/loopback
+[loopback_3]: http://loopback-dot-nodejs-docs-samples.appspot.com
+[loopback_4]: http://loopback.io/
+
+[koa_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/koa
+[koa_2]: https://cloud.google.com/nodejs/resources/frameworks/koa
+[koa_3]: http://koa-dot-nodejs-docs-samples.appspot.com
+[koa_4]: http://koajs.com/
+
+[kraken_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/kraken
+[kraken_2]: https://cloud.google.com/nodejs/resources/frameworks/kraken
+[kraken_3]: http://kraken-dot-nodejs-docs-samples.appspot.com
+[kraken_4]: http://krakenjs.com/
+
+[parse_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/parse-server
+
+[restify_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/restify
+[restify_2]: https://cloud.google.com/nodejs/resources/frameworks/restify
+[restify_3]: http://restify-dot-nodejs-docs-samples.appspot.com
+[restify_4]: http://restify.com/
+
+[sails_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/sails
+[sails_2]: https://cloud.google.com/nodejs/resources/frameworks/sails
+[sails_3]: http://sails-dot-nodejs-docs-samples.appspot.com
+[sails_4]: http://sailsjs.org/
+
+[aedatastore_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/datastore
+[aecloudsql_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/cloudsql
+[memcached_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/memcached
+
+[mongodb_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/mongodb
+[mongodb_2]: https://cloud.google.com/nodejs/resources/databases/mongodb
+[mongodb_3]: https://docs.mongodb.org/
+
+[redis_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/redis
+[redis_2]: https://cloud.google.com/nodejs/resources/databases/redis
+[redis_3]: https://redis.io/
+
+[gcloud_1]: https://github.com/GoogleCloudPlatform/gcloud-node
+[gcloud_2]: https://googlecloudplatform.github.io/gcloud-node/#/
+
+[bower_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/bower
+[bower_2]: https://cloud.google.com/nodejs/resources/tools/bower
+[bower_3]: http://bower.io/
+
+[grunt_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/grunt
+[grunt_2]: https://cloud.google.com/nodejs/resources/tools/grunt
+[grunt_3]: http://grunt-dot-nodejs-docs-samples.appspot.com
+[grunt_4]: http://gruntjs.com/
+
+[mailgun_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/mailgun
+[mailgun_2]: https://cloud.google.com/nodejs/resources/tools/mailgun
+[mailgun_3]: http://www.mailgun.com/
+
+[sendgrid_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/sendgrid
+[sendgrid_2]: https://cloud.google.com/nodejs/resources/tools/sendgrid
+[sendgrid_3]: http://sendgrid.com/
+
+[twilio_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/twilio
+
+[webpack_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/webpack
+[webpack_2]: https://cloud.google.com/nodejs/resources/tools/webpack
+[webpack_3]: https://webpack.github.io/
+
+[websockets_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/websockets
+
+[expresshw_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/hello-world
+[aedisk_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/disk
+[aeextending_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/extending-runtime
+[aestaticfiles_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/appengine/static-files

appengine/README.md

@@ -1,41 +1,84 @@
-## BigQuery Samples
+<img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
 
-These samples require two environment variables to be set:
+# Google BigQuery Node.js Samples
 
-- `GOOGLE_APPLICATION_CREDENTIALS` - Path to a service account file. You can
-download one from your Google project's "permissions" page.
-- `GCLOUD_PROJECT` - Id of your Google project.
+[BigQuery][bigquery_docs] is Google's fully managed, petabyte scale, low cost
+analytics data warehouse.
 
-## Run the samples
+[bigquery_docs]: https://cloud.google.com/bigquery/docs/
 
-Install dependencies:
+## Table of Contents
 
-    npm install
+* [Setup](#setup)
+* [Samples](#samples)
+  * [Create A Simple Application With the API](#create-a-simple-application-with-the-api)
+  * [Calculate size of dataset](#calculate-size-of-dataset)
+  * [Loading Data with a POST Request](#loading-data-with-a-post-request)
+  * [Loading Data from Cloud Storage](#loading-data-from-cloud-storage)
 
-### getting_started.js
+## Setup
 
-    npm run getting_started
+1. Read [Prerequisites][prereq] and [How to run a sample][run] first.
+1. Install dependencies:
 
-### dataset_size.js
+        npm install
 
-Usage: `npm run dataset_size -- <projectId> <datasetId>`
+[prereq]: ../README.md#prerequisities
+[run]: ../README.md#how-to-run-a-sample
+
+## Samples
+
+### Create A Simple Application With the API
+
+View the [documentation][basics_1] or the [source code][basics_2].
+
+__Run the sample:__
+
+    node getting_started
+
+[basics_1]: getting_started.js
+[basics_2]: https://cloud.google.com/bigquery/create-simple-app-api
+
+### Calculate size of dataset
+
+View the [source code][size_1].
+
+__Run the sample:__
+
+Usage: `node dataset_size <projectId> <datasetId>`
 
 Example:
 
-    npm run dataset_size -- bigquery-public-data hacker_news
+    node dataset_size bigquery-public-data hacker_news
+
+[size_1]: dataset_size.js
+
+### Loading Data with a POST Request
+
+View the [documentation][file_1] or the [source code][file_2].
 
-### load_data_from_csv.js
+__Run the sample:__
 
-Usage: `npm run load_data_from_csv -- <path-to-file> <dataset-id> <table-name>`
+Usage: `node load_data_from_csv <path-to-file> <dataset-id> <table-name>`
 
 Example:
 
-    npm run load_data_from_csv -- data.csv my-dataset my-table
+    node load_data_from_csv resources/data.csv my-dataset my-table
 
-### load_data_from_gcs.js
+[file_1]: load_data_from_csv.js
+[file_2]: https://cloud.google.com/bigquery/loading-data-post-request
 
-Usage: `npm run load_data_from_gcs -- <bucket-name> <filename> <dataset-id> <table-name>`
+### Loading Data from Cloud Storage
+
+View the [documentation][gcs_1] or the [source code][gcs_2].
+
+__Run the sample:__
+
+Usage: `node load_data_from_gcs <bucket-name> <filename> <dataset-id> <table-name>`
 
 Example:
 
-    npm run load_data_from_gcs -- my-bucket data.csv my-dataset my-table
+    node load_data_from_gcs my-bucket data.csv my-dataset my-table
+
+[gcs_1]: load_data_from_gcs.js
+[gcs_2]: https://cloud.google.com/bigquery/docs/loading-data-cloud-storage

bigquery/README.md

@@ -33,3 +33,11 @@ set.
 
     npm run vms_api
 
+- Sendgrid sample - [Source code][compute_sendgrid_1] | [Documentation][compute_sendgrid_2]
+- VMs sample - [Source code][compute_vms_1] | [Documentation][compute_vms_2]
+
+[compute_sendgrid_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/computeengine/sendgrid.js
+[compute_sendgrid_2]: https://cloud.google.com/compute/docs/tutorials/sending-mail/using-sendgrid
+
+[compute_vms_1]: https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/computeengine/vms.js
+[compute_vms_2]: https://cloud.google.com/compute/docs/tutorials/nodejs-guide

computeengine/README.md

@@ -1,33 +1,65 @@
-## Datastore Samples
+<img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
 
-These samples require two environment variables to be set:
+# Google Cloud Datastore Node.js Samples
 
-- `GOOGLE_APPLICATION_CREDENTIALS` - Path to a service account file. You can
-download one from your Google project's "permissions" page.
-- `GCLOUD_PROJECT` - Id of your Google project.
+[Cloud Datastore][datastore_docs] is a NoSQL document database built for
+automatic scaling, high performance, and ease of application development.
 
-## Run a sample
+[datastore_docs]: https://cloud.google.com/datastore/docs/
 
-Install dependencies:
+## Table of Contents
 
-```
-$ npm install
-```
+* [Setup](#setup)
+* [Samples](#samples)
+  * [Getting started with Google Cloud Datastore API](#getting-started-with-google-cloud-datastore-api)
+  * [Concepts](#concepts)
+  * [Errors and Error Handling](#errors-and-error-handling)
 
-To print available commands:
+## Setup
 
-```
-$ npm run
-```
+1. Read [Prerequisites][prereq] and [How to run a sample][run] first.
+1. Install dependencies:
 
-Execute a sample:
+        npm install
 
-```
-$ npm run <sample> -- [arg_1] [arg_2] [arg_n]
-```
+[prereq]: ../README.md#prerequisities
+[run]: ../README.md#how-to-run-a-sample
+
+## Samples
+
+### Getting started with Google Cloud Datastore API
+
+View the [documentation][tasks_1] or the [source code][tasks_2].
+
+__Run the sample:__
+
+Usage: `node tasks <command> [args]...`
+
+Print usage:
+
+    node tasks
 
 Example:
 
-```
-$ npm run tasks -- list
-```
+    node tasks list
+
+[tasks_1]: tasks.js
+[tasks_2]: https://cloud.google.com/datastore/docs/datastore-api-tutorial
+
+### Concepts
+
+View the [documentation][concepts_1] or the [source code][concepts_2].
+
+[concepts_1]: concepts.js
+[concepts_2]: https://cloud.google.com/datastore/docs/concepts/entities
+
+### Errors and Error Handling
+
+View the [documentation][error_1] or the [source code][error_2].
+
+__Run the sample:__
+
+    node error
+
+[error_1]: error.js
+[error_2]: https://cloud.google.com/datastore/docs/concepts/errors

datastore/README.md

@@ -0,0 +1,26 @@
+<img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
+
+# Google Cloud Functions Node.js Samples
+
+[Cloud Functions][functions_docs] is a lightweight, event-based, asynchronous
+compute solution that allows you to create small, single-purpose functions that
+respond to Cloud events without the need to manage a server or a runtime
+environment.
+
+[functions_signup]: https://docs.google.com/a/google.com/forms/d/1WQNWPK3xdLnw4oXPT_AIVR9-gd6DLo5ZIucyxzSQ5fQ/viewform
+[functions_docs]: https://cloud.google.com/functions/docs/
+
+## Setup
+
+1. Read [Prerequisites][prereq] and [How to run a sample][run] first.
+
+[prereq]: ../README.md#prerequisities
+[run]: ../README.md#how-to-run-a-sample
+
+## Samples
+
+* [Hello World](helloworld/)
+* [Logging](log/)
+* [Callbacks](messages/)
+* [Modules](module/)
+* [Dependencies](uid/)