docs: new synthtool generated README (#645)

Author: Benjamin E. Coe

.gitignore

@@ -13,3 +13,4 @@ google-cloud-logging-winston-*.tgz
 google-cloud-logging-bunyan-*.tgz
 .vscode
 package-lock.json
+__pycache__

.readme-partials.yaml

@@ -0,0 +1,8 @@
+introduction: |-
+    > Node.js idiomatic client for [Cloud Storage][product-docs].
+
+    [Cloud Storage](https://cloud.google.com/storage/docs) allows world-wide
+    storage and retrieval of any amount of data at any time. You can use Google
+    Cloud Storage for a range of scenarios including serving website content,
+    storing data for archival and disaster recovery, or distributing large data
+    objects to users via direct download.

.repo-metadata.json

@@ -2,7 +2,7 @@
   "name": "storage",
   "name_pretty": "Google Cloud Storage",
   "product_documentation": "https://cloud.google.com/storage",
-  "client_documentation": "https://cloud.google.com/nodejs/docs/reference/storage/2.3.x/",
+  "client_documentation": "https://cloud.google.com/nodejs/docs/reference/storage/latest/",
   "issue_tracker": "https://issuetracker.google.com/savedsearches/559782",
   "release_level": "ga",
   "language": "nodejs",

README.md

@@ -9,45 +9,76 @@
 [![codecov](https://img.shields.io/codecov/c/github/googleapis/nodejs-storage/master.svg?style=flat)](https://codecov.io/gh/googleapis/nodejs-storage)
 
 
-Cloud Storage Client Library for Node.js
 
 
-* [Using the client library](#using-the-client-library)
+> Node.js idiomatic client for [Cloud Storage][product-docs].
+
+[Cloud Storage](https://cloud.google.com/storage/docs) allows world-wide
+storage and retrieval of any amount of data at any time. You can use Google
+Cloud Storage for a range of scenarios including serving website content,
+storing data for archival and disaster recovery, or distributing large data
+objects to users via direct download.
+
+
+* [Google Cloud Storage Node.js Client API Reference][client-docs]
+* [Google Cloud Storage Documentation][product-docs]
+* [github.com/googleapis/nodejs-storage](https://github.com/googleapis/nodejs-storage)
+
+Read more about the client libraries for Cloud APIs, including the older
+Google APIs Client Libraries, in [Client Libraries Explained][explained].
+
+[explained]: https://cloud.google.com/apis/docs/client-libraries-explained
+
+**Table of contents:**
+
+
+* [Quickstart](#quickstart)
+  * [Before you begin](#before-you-begin)
+  * [Installing the client library](#installing-the-client-library)
+  * [Using the client library](#using-the-client-library)
 * [Samples](#samples)
 * [Versioning](#versioning)
 * [Contributing](#contributing)
 * [License](#license)
 
-## Using the client library
+## Quickstart
+
+### Before you begin
 
 1.  [Select or create a Cloud Platform project][projects].
 1.  [Enable billing for your project][billing].
 1.  [Enable the Google Cloud Storage API][enable_api].
 1.  [Set up authentication with a service account][auth] so you can access the
     API from your local workstation.
 
-1. Install the client library:
+### Installing the client library
 
-        npm install @google-cloud/storage
+```bash
+npm install @google-cloud/storage
+```
 
 
-1. Try an example:
+### Using the client library
 
 ```javascript
-async function quickstart(
-  projectId = 'YOUR_PROJECT_ID', // Your Google Cloud Platform project ID
-  bucketName = 'my-new-bucket' // The name for the new bucket
-) {
   // Imports the Google Cloud client library
   const {Storage} = require('@google-cloud/storage');
 
   // Creates a client
-  const storage = new Storage({projectId});
+  const storage = new Storage();
+
+  /**
+   * TODO(developer): Uncomment these variables before running the sample.
+   */
+  // const bucketName = 'bucket-name';
+
+  async function createBucket() {
+    // Creates the new bucket
+    await storage.createBucket(bucketName);
+    console.log(`Bucket ${bucketName} created.`);
+  }
 
-  // Creates the new bucket
-  await storage.createBucket(bucketName);
-  console.log(`Bucket ${bucketName} created.`);
-}
+  createBucket();
 
 ```
 
@@ -103,18 +134,7 @@ Apache Version 2.0
 
 See [LICENSE](https://github.com/googleapis/nodejs-storage/blob/master/LICENSE)
 
-## What's Next
-
-* [Google Cloud Storage Documentation][product-docs]
-* [Google Cloud Storage Node.js Client API Reference][client-docs]
-* [github.com/googleapis/nodejs-storage](https://github.com/googleapis/nodejs-storage)
-
-Read more about the client libraries for Cloud APIs, including the older
-Google APIs Client Libraries, in [Client Libraries Explained][explained].
-
-[explained]: https://cloud.google.com/apis/docs/client-libraries-explained
-
-[client-docs]: https://cloud.google.com/nodejs/docs/reference/storage/2.3.x/
+[client-docs]: https://cloud.google.com/nodejs/docs/reference/storage/latest/
 [product-docs]: https://cloud.google.com/storage
 [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
 [projects]: https://console.cloud.google.com/project

synth.metadata

@@ -1,5 +1,5 @@
 {
-  "updateTime": "2019-03-27T11:27:46.413216Z",
+  "updateTime": "2019-03-27T23:29:22.642318Z",
   "sources": [
     {
       "template": {