@@ -19,91 +19,22 @@ https://bazelbuild.github.io/rules_nodejs/
 
 ## Quickstart
 
-This is the most common workflow to get started.
+This is the fastest way to get started.
 See sections below for details and alternative methods.
 
-1. Add dependencies
-
-    ```sh
-    $ yarn add -D @bazel/bazel @bazel/ibazel @bazel/buildifier
-    ```
-
-    or if you prefer `npm`,
-
-    ```sh
-    $ npm install --save-dev @bazel/bazel @bazel/ibazel @bazel/buildifier
-    ```
-
-1. Create a file called `WORKSPACE` in the root of your repo, containing
-
-    ```python
-    load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
-    http_archive(
-        name = "build_bazel_rules_nodejs",
-        sha256 = "abcf497e89cfc1d09132adfcd8c07526d026e162ae2cb681dcb896046417ce91",
-        urls = ["https://github.com/bazelbuild/rules_nodejs/releases/download/0.30.1/rules_nodejs-0.30.1.tar.gz"],
-    )
-
-    load("@build_bazel_rules_nodejs//:defs.bzl", "yarn_install")
-    yarn_install(
-        name = "npm",
-        package_json = "//:package.json",
-        yarn_lock = "//:yarn.lock",
-    )
-    
-    load("@npm//:install_bazel_dependencies.bzl", "install_bazel_dependencies")
-    install_bazel_dependencies()
-    ```
-
-    or if you used `npm`:
-
-    ```python
-    load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
-    http_archive(
-        name = "build_bazel_rules_nodejs",
-        sha256 = "abcf497e89cfc1d09132adfcd8c07526d026e162ae2cb681dcb896046417ce91",
-        urls = ["https://github.com/bazelbuild/rules_nodejs/releases/download/0.30.1/rules_nodejs-0.30.1.tar.gz"],
-    )
-
-    load("@build_bazel_rules_nodejs//:defs.bzl", "npm_install")
-    npm_install(
-        name = "npm",
-        package_json = "//:package.json",
-        package_lock_json = "//:package-lock.json",
-    )
-    
-    load("@npm//:install_bazel_dependencies.bzl", "install_bazel_dependencies")
-    install_bazel_dependencies()
-    ```
-
-1. Since Bazel manages a copy of the node_modules, we don't want it to discover configuration in your locally installed copy. Create a file `.bazelignore` in the root of your repo containing this line:
-
-    ```
-    node_modules
-    ```
-
-1. Create a file `BUILD.bazel` in the root of your repo, next to the `package.json` file. It can be empty for now.
-
-1. In your `package.json`, find the `"scripts"` section, or create one.
-
-    ```json
-    "scripts": {
-        "build": "bazel build //...",
-        "test": "ibazel test //..."
-    }
-    ```
+```sh
+$ npm init @bazel
+```
 
-1. Test that you can do an initial build. It will report that no targets were found yet.
+or if you prefer yarn,
 
-    ```sh
-    $ yarn build
-    ```
+```sh
+$ yarn create @bazel
+```
 
-    or 
+> These commands are equivalent to `npx run @bazel/create` which downloads the latest version of the `@bazel/create` package from npm and runs the program contained.
 
-    ```sh
-    $ npm run build
-    ```
+See the output of the tool for command-line options and next steps.
 
 ## Adding Build Targets
 
 
@@ -46,7 +46,8 @@ function usage(error) {
     yarn create @bazel [workspace name] [options...]
 
   Options:
-    --packageManager=[yarn|npm]   Select npm or yarn to install packages (default: npm)
+    --packageManager=[yarn|npm]   Select npm or yarn to install packages
+                                  (default: npm if you ran npm/npx, yarn if you ran yarn create)
     --typescript                  Set up the workspace for TypeScript development
 
   Run @bazel/create --help to see all options
@@ -191,17 +192,14 @@ install_bazel_dependencies()`);
 
   log(`Successfully created new Bazel workspace at ${path.resolve(wkspDir)}`);
   // TODO: we should probably run the package manager install now
-  if (pkgMgr === 'yarn') {
-    log(`Now in that directory, you can run
-    yarn install
-    yarn build
-    yarn test`);
-  } else {
-    log(`Now in that directory, you can run
-    npm install
-    npm run build
-    npm test`);
-  }
+
+  log(`Next steps:
+  1. cd ${wkspDir}
+  2. ${pkgMgr} install
+  3. ${pkgMgr === 'yarn' ? 'yarn build' : 'npm run build'}
+     Note that there is nothing to build, so this trivially succeeds.
+  4. Add contents to the BUILD.bazel file or create a new BUILD.bazel in a subdirectory.
+  `);
 
   return 0;
 }