Skip to content

Latest commit

 

History

History
60 lines (38 loc) · 2.58 KB

CONTRIBUTING.md

File metadata and controls

60 lines (38 loc) · 2.58 KB

Contributing

This doc explains how The New Router is developed, and how you can help improve it.

Methodology

You can see daily progress and goals in the progress doc. Individual tasks are mostly tracked as issues on GitHub.

Giving Feedback

Please check existing issues and PRs (including ones that have already been closed) before filing new ones. That being said, all forms of feedback are welcome: bug reports, feature requests, use cases, and questions.

GitHub Labels

Most of the use cases are self-explanatory, so they are omitted.

  • pair - issues that @btford wants to use or pairing with other Angular Core team members to get feedback.
  • type: use case - issues that describe a common usage scenario. Should be closed by adding an example to examples/angular-1/, complete with docs and an e2e test.

GitHub Milestones

  • v0.x.y - This is the list of tasks that I'm aiming to get done this week. I'll be closing these and cutting releases on Fridays.
  • pre ng-conf - these tasks need to be taken care of before the beginning of March.
  • post ng-conf - these tasks need to be taken care of eventually.

After ng-conf, I'll likely reorganize these labels.

Releases

Releases of this module live in the dist directory. Releases (tagged vx.y.z) of this module published on npm or will have up-to-date build artifacts checked in.

Development

This section explains how to build the router module yourself.

Setup

This doc explains how to build the router module yourself.

  1. Install NodeJS
  2. Install Gulp with npm install -g gulp
  3. Clone and cd into this repo.
  4. Install dependencies with npm install
  5. Run gulp build to build the new files.

Running the Examples

  1. Start the development server with gulp build watch serve
  2. Open a browser and navigate to http://localhost:8000/examples/angular-1/hello

Running the Tests

  1. Install Karma with npm install -g karma
  2. Install the CLI for Karma with npm install -g karma-cli
  3. Start karma with karma start
  4. Add new tests to the test folder. Be sure to give them an extension of .spec.js.