Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
124 lines (78 loc) · 2.65 KB

CONTRIBUTING.md

File metadata and controls

124 lines (78 loc) · 2.65 KB

CONTRIBUTING

Contributions are always welcome, no matter how large or small. Before contributing, please read the code of conduct.

Setup

Install node & npm on your system: https://nodejs.org/en/download/

Install dependencies

Only required when setting up the project

$ git clone https://github.com/davidwells/analytics
$ cd analytics
$ npm run setup

Because analytics has a large number of packages, we need to also install watchmen for better watching.

brew update
brew install watchman

Run locally

$ npm start

Available scripts

setup

Installs and sets up all analytics package dependencies.

Usage

$ npm run setup

watch

Watches all analytics packages and builds them on change.

Usage

$ npm run watch

start

Starts the development server. This task runs both the setup and watch scripts.

Usage

$ npm start

clean

Removes all of the analytics packages dist directories.

Usage

npm run clean

reset

Runs the clean script and removes all the node_modules from the analytics packages.

Usage

npm run reset

build

Runs the clean script and builds the analytics packages.

Usage

npm run build

test

Runs all the analytics packages tests.

Usage

npm run test

Pull Requests

We actively welcome your pull requests!

If you need help with Git or our workflow, please ask on David on twitter. We want your contributions even if you're just learning Git. Our maintainers are happy to help!

Analytics uses the Forking Workflow + Feature Branches. Additionally, PR's should be rebased on master when opened, and again before merging.

  1. Fork the repo.
  2. Create a branch from master. If you're addressing a specific issue, prefix your branch name with the issue number.
  3. If you've added code that should be tested, add tests.
  4. If you've changed APIs, update the documentation.
  5. Run npm run test and ensure the test suite passes.
  6. PR's must be rebased before merge (feel free to ask for help).
  7. PR should be reviewed by two maintainers prior to merging.

License

By contributing to analytics, you agree that your contributions will be licensed under its MIT license.