Improve README

1 files changed, 27 insertions, 12 deletions

diff --git a/packages/dev-tools-pages/README.md b/packages/dev-tools-pages/README.md
index ce8edc103..b7bdf3bc3 100644
--- a/packages/dev-tools-pages/README.md
+++ b/packages/dev-tools-pages/README.md
@@ -2,23 +2,19 @@
 
 This repository contains our dev tools pages.
 
-## Contributing
-
-We strongly recommend that the community help us make improvements and determine the future direction of the protocol. To report bugs within this package, please create an issue in this repository.
-
-Please read our [contribution guidelines](../../CONTRIBUTING.md) before getting started.
-
 ## Local Dev Setup
 
-Requires Node version 6.9.5 or higher
+Requires Node version 6.9.5 or higher & yarn v1.9.4
+
+### 1. Install dependencies for monorepo:
 
-### Install dependencies:
+Make sure you install Yarn v1.9.4 (npm won't work!). We rely on our `yarn.lock` file and on Yarn's support for `workspaces` in our monorepo setup.
 
 ```bash
 yarn install
 ```
 
-### Initial setup
+### 2. Initial setup
 
 To build this package and all other monorepo packages that it depends on, run the following from the monorepo root directory:
 
@@ -26,14 +22,19 @@ To build this package and all other monorepo packages that it depends on, run th
 PKG=@0xproject/dev-tools-pages yarn build
 ```
 
-### Run dev server
+Note: Ignore the `WARNING in asset size limit` and `WARNING in entrypoint size limit` warnings.
+
+### 3. Run dev server
 
 ```bash
-PKG=@0xproject/dev-tools-pages yarn watch
+cd packages/dev-tools-pages
+yarn dev
 ```
 
 Visit [http://localhost:3572/](http://localhost:3572/) in your browser.
 
+The webpage will refresh when source code is changed.
+
 ### Clean
 
 ```bash
@@ -46,14 +47,28 @@ yarn clean
 yarn lint
 ```
 
+### Prettier
+
+Run from the monorepo root directory:
+
+```
+yarn prettier
+```
+
 ### Resources
 
 ##### Toolkit
 
 *   [Styled Components](https://www.styled-components.com/)
-*   [Rebass](https://rebassjs.org/)
+*   [BassCSS](http://basscss.com/)
 
 ##### Recommended Atom packages:
 
 *   [atom-typescript](https://atom.io/packages/atom-typescript)
 *   [linter-tslint](https://atom.io/packages/linter-tslint)
+
+## Contributing
+
+We strongly recommend that the community help us make improvements and determine the future direction of the protocol. To report bugs within this package, please create an issue in this repository.
+
+Please read our [contribution guidelines](../../CONTRIBUTING.md) before getting started.