Update documentation to use yarn build (#1681)

* Add option to specify projectId in `yarn test:setup`.
* Test set up details added to CONTRIBUTING.md in `firestore` package.

Author: Brian Chen

README.md

@@ -36,7 +36,7 @@ or [`N`](https://github.com/tj/n) to install and manage multiple node versions_
 
 In addition to Node.js we use `yarn` to facilitate multi package development.
 
-To install `yarn` follow the instructions listed on their website: 
+To install `yarn` follow the instructions listed on their website:
 https://yarnpkg.com/en/docs/install
 
 #### Java
@@ -70,6 +70,13 @@ by running the following at the root of the SDK:
 $ yarn
 ```
 
+Once you have installed all the dependencies, you can build the entire SDK by
+running the following command the root of the SDK:
+
+```bash
+$ yarn build
+```
+
 ## Testing the SDK
 
 ### Test Setup
@@ -85,23 +92,29 @@ them below.
 
 #### Authentication Support
 
-Visit the authentication config in your project and enable the `Anonymous` 
+Visit the authentication config in your project and enable the `Anonymous`
 sign-in provider to complete your project config.
 
 #### Automated Setup
 
-The remainder of the test setup can be done by running the following command at
-the root of the package:
+The remainder of the test setup requires choosing a test project. You can 
+choose the project manually or specify the project directly at the root of 
+the package.
 
 ```bash
-yarn test:setup
+# Select a project manually when running setup
+$ yarn test:setup
+
+# Specify the specific project for setup
+$ yarn test:setup --projectId=<your-test-project>
 ```
 
 ### Running the tests
 
 Each of the directories in the `integration` directory as well as the `packages`
-directory have their own test suites. These can be run altogether by running the
-following command at the root of the package:
+directory have their own test suites. You will need to build the SDK before
+running tests. Test suites can be run all together by running the following 
+command at the root of the package:
 
 ```bash
 $ yarn test
@@ -115,13 +128,13 @@ an individual package directory.
 ### Introduction
 
 The Firebase JS SDK is built with a series of individual packages that are all
-contained in this repository. Development is coordinated via [yarn 
-workspaces](https://yarnpkg.com/blog/2017/08/02/introducing-workspaces/) and 
+contained in this repository. Development is coordinated via [yarn
+workspaces](https://yarnpkg.com/blog/2017/08/02/introducing-workspaces/) and
 [Lerna](https://lernajs.io/) (a monorepo management tool).
 
 Each package in the `packages` directory, constitute a piece of our
 implementation. The SDK is built via a combination of all of these packages
-which are published under the [`firebase` 
+which are published under the [`firebase`
 scope](https://www.npmjs.com/search?q=scope%3Afirebase) on NPM.
 
 ### Helper Scripts
@@ -134,12 +147,12 @@ watch tasks as well as a sandbox server.
 You can run the dev script by running the following at the root of the package:
 
 ```bash
-yarn dev
+$ yarn dev
 ```
 
 ### Prepush Hooks
 
-As part of this repo, we use the NPM package [`husky`](https://npm.im/husky) to 
+As part of this repo, we use the NPM package [`husky`](https://npm.im/husky) to
 implement git hooks. We leverage the prepush hook to do two things:
 
 - Automated code styling (using [`prettier`](https://npm.im/prettier))

packages/firestore/CONTRIBUTING.md

@@ -2,10 +2,29 @@
 
 See [Contributing](../../CONTRIBUTING.md) for general information on
 contributing to the Firebase JavaScript SDK (including Cloud Firestore).
+Follow instructions there to install dependencies, build the SDK, and set up
+the testing environment.
+
+## Setting up a project for testing
+
+You will need a production project to test the Firestore SDK. You can create
+a new project by visiting the 
+[Firebase Console](https://console.firebase.google.com/). Make sure that the 
+project has Cloud Firestore enabled in the database section of the console.
+
+See 
+[Automated Setup](https://github.com/firebase/firebase-js-sdk#automated-setup) 
+for more details.
+
 
 ## Running Firestore Tests
+
 All commands must be run from this `packages/firestore/` directory.
+
 ```
+# Come up to date on dependencies after performing git pull
+(cd ../../; yarn && yarn build)
+
 # Run all tests once (browser and node)
 yarn test