| Index: third_party/pkg/angular/DEVELOPER.md
 | 
| diff --git a/third_party/pkg/angular/DEVELOPER.md b/third_party/pkg/angular/DEVELOPER.md
 | 
| deleted file mode 100644
 | 
| index ec2f93254e0ae90ef44d7966098466d76af0c096..0000000000000000000000000000000000000000
 | 
| --- a/third_party/pkg/angular/DEVELOPER.md
 | 
| +++ /dev/null
 | 
| @@ -1,167 +0,0 @@
 | 
| -# Building and Testing AngularDart
 | 
| -
 | 
| -This document describes how to set up your development environment to build and test AngularDart, and
 | 
| -explains the basic mechanics of using `git`, `node`, and `npm`.
 | 
| -
 | 
| -See the [contributing guidelines](https://github.com/angular/angular.dart/blob/master/CONTRIBUTING.md) for how to contribute your own code to 
 | 
| -
 | 
| -1. [Prerequisite Software](#prerequisite-software)
 | 
| -2. [Getting the Sources](#getting-the-sources)
 | 
| -3. [Environment Variable Setup](#environment-variable-setup)
 | 
| -4. [Installing NPM Modules and Dart Packages](#installing-npm-modules-and-dart-packages)
 | 
| -5. [Running Tests Locally](#running-tests-locally)
 | 
| -6. [Continuous Integration using Travis](#continuous-integration-using-travis)
 | 
| -
 | 
| -## Prerequisite Software
 | 
| -
 | 
| -Before you can build and test AngularDart, you must install and configure the
 | 
| -following products on your development machine:
 | 
| -
 | 
| -* [Dart](https://www.dartlang.org/): as can be expected, AngularDart requires
 | 
| -  an installation of the Dart-SDK and Dartium (a version of
 | 
| -  [Chromium](http://www.chromium.org) with native support for Dart through the
 | 
| -  Dart VM). One of the **simplest** ways to get both is to install the **Dart
 | 
| -  Editor bundle**, which includes the editor, sdk and Dartium. See the [Dart
 | 
| -  tools download page for
 | 
| -  instructions](https://www.dartlang.org/tools/download.html).
 | 
| -
 | 
| -* [Git](http://git-scm.com/) and/or the **Github app** (for
 | 
| -  [Mac](http://mac.github.com/) or [Windows](http://windows.github.com/)): the
 | 
| -  [Github Guide to Installing
 | 
| -  Git](https://help.github.com/articles/set-up-git) is a good source of
 | 
| -  information.
 | 
| -
 | 
| -* [Node.js](http://nodejs.org): We use Node to run a development web server,
 | 
| -  run tests, and generate distributable files. We also use Node's Package
 | 
| -  Manager (`npm`). Depending on your system, you can install Node either from
 | 
| -  source or as a pre-packaged bundle.
 | 
| -
 | 
| -## Getting the Sources
 | 
| -
 | 
| -Forking and Cloning the AngularDart repository:
 | 
| -
 | 
| -1. Login to your Github account or create one by following the instructions given [here](https://github.com/signup/free).
 | 
| -Afterwards.
 | 
| -2. [Fork](http://help.github.com/forking) the [main AngularDart repository](https://github.com/angular/angular.dart).
 | 
| -3. Clone your fork of the AngularDart repository and define an `upstream` remote pointing back to the AngularDart repository that you forked in the first place:
 | 
| -
 | 
| -```shell
 | 
| -# Clone your Github repository:
 | 
| -git clone git@github.com:<github username>/angular.dart.git
 | 
| -
 | 
| -# Go to the AngularDart directory:
 | 
| -cd angular.dart
 | 
| -
 | 
| -# Add the main AngularDart repository as an upstream remote to your repository:
 | 
| -git remote add upstream https://github.com/angular/angular.dart.git
 | 
| -```
 | 
| -
 | 
| -## Environment Variable Setup
 | 
| -
 | 
| -
 | 
| -Define the environment variables listed below. These are mainly needed for the
 | 
| -test scripts. The notation shown here is for
 | 
| -[`bash`](http://www.gnu.org/software/bash/); adapt as appropriate for your
 | 
| -favorite shell. (Examples given below of possible values for initializing the
 | 
| -environment variables assume Mac OS X and that you have installed the Dart
 | 
| -Editor in the directory named by `$DART_EDITOR_DIR`. This is only for
 | 
| -illustrative purposes.)
 | 
| -
 | 
| -```shell
 | 
| -# CHROME_BIN: path to a Chrome browser executable; e.g.,
 | 
| -export CHROME_BIN="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
 | 
| -
 | 
| -# CHROME_CANARY_BIN: path to a Dartium browser executable; e.g.,
 | 
| -export CHROME_CANARY_BIN="$DART_EDITOR_DIR/chromium/Chromium.app/Contents/MacOS/Chromium"
 | 
| -```
 | 
| -**Note**: the `$CHROME_CANARY_BIN` environment variable is used by karma to run your tests
 | 
| -in dartium instead of chromium. If you don't do this, the dart2js compile will make the tests
 | 
| -run extremely slow since it has to wait for a full js compile each time.
 | 
| -
 | 
| -You should also add the Dart SDK `bin` directory to your path and/or define `DART_SDK`; e.g.
 | 
| -
 | 
| -```shell
 | 
| -# DART_SDK: path to a Dart SDK directory; e.g.,
 | 
| -export DART_SDK="$DART_EDITOR_DIR/dart-sdk"
 | 
| -
 | 
| -# Update PATH to include the Dart SDK bin directory
 | 
| -PATH+=":$DART_SDK/bin"
 | 
| -```
 | 
| -## Installing NPM Modules and Dart Packages
 | 
| -
 | 
| -Next, install the modules and packages needed to run AngularDart tests:
 | 
| -
 | 
| -```shell
 | 
| -# Install node.js dependencies:
 | 
| -npm install
 | 
| -
 | 
| -# Install karma onto your command line (optional)
 | 
| -npm install karma -g
 | 
| -
 | 
| -# Install Dart packages
 | 
| -pub install
 | 
| -```
 | 
| -
 | 
| -## Running Tests Locally
 | 
| -
 | 
| -NOTE: scripts are being written to embody the following steps.
 | 
| -
 | 
| -To run base tests:
 | 
| -
 | 
| -```shell
 | 
| -# Source a script to define yet more environment variables
 | 
| -. ./scripts/env.sh
 | 
| -
 | 
| -# Run io tests:
 | 
| -dart --checked test/io/all.dart
 | 
| -
 | 
| -# Run expression extractor tests:
 | 
| -scripts/test-expression-extractor.sh
 | 
| -
 | 
| -Run the Dart Analyzer:
 | 
| -./scripts/analyze.sh
 | 
| -```
 | 
| -
 | 
| -To run Karma tests over Dartium, execute the following shell commands (which
 | 
| -will launch the Karma server):
 | 
| -
 | 
| -```shell
 | 
| -. ./scripts/env.sh
 | 
| -node "node_modules/karma/bin/karma" start karma.conf \
 | 
| -    --reporters=junit,dots --port=8765 --runner-port=8766 \
 | 
| -    --browsers=Dartium
 | 
| -```
 | 
| -
 | 
| -In another shell window or tab, or from your favorite IDE, launch the Karma
 | 
| -tests proper by executing:
 | 
| -
 | 
| -```shell
 | 
| -. ./scripts/env.sh
 | 
| -karma_run.sh
 | 
| -```
 | 
| -
 | 
| -**Note:**: If the dart analyzer fails with warnings, the tests will not run.
 | 
| -You can manually run the tests if this happens: 
 | 
| -
 | 
| -```shell
 | 
| -karma run --port=8765
 | 
| -```
 | 
| -
 | 
| -## Debugging
 | 
| -
 | 
| -In the dart editor you can configure a dartium launch target for the karma test runner debug page.
 | 
| -The menu option is under Run > Manage Launches > Create new Dartium Launch.
 | 
| -
 | 
| -```
 | 
| -http://localhost:8765/debug.html
 | 
| -```
 | 
| -
 | 
| -If you want to only run a single test you can alter the test you wish to run by changing `it` to `iit`
 | 
| -or `describe` to `ddescribe`. This will only run that individual test and make it much easier to debug.
 | 
| -
 | 
| -
 | 
| -## Continuous Integration using Travis
 | 
| -
 | 
| -See the instructions given [here](https://github.com/angular/angular.dart/blob/master/travis.md).
 | 
| -
 | 
| ------
 | 
| 
 |