2.1 KiB

Raw Blame History

Contributing

Fork the repo on github and send a pull requests with topic branches. Do not forget to provide specs to your contribution.

Running specs

Prerequisites

Steps (Testing Locally)

Install prerequisites
Ensure all servers are running on the default port of localhost
Fork and clone the repository; enter the repository directory
Run npm install
Run npm test (repeat as necessary)

MacOS Notes

All prerequisites can be installed with Homebrew. After installing Homebrew, execute:

$ brew install zmq rabbitmq redis mongodb

After installation of each server, Homebrew should print further instructions.

Steps (Testing with Vagrant)

A Vagrant installation will provide a virtual machine with all prerequisites installed for you. If you are having trouble installing the prerequisites locally (or do not wish to), try this method instead.

Install Vagrant
Install VirtualBox
Fork and clone the repository; enter the repository directory. Do not run npm install.
Run vagrant up. Wait.
Run vagrant ssh -c 'cd /vagrant && npm install
Run vagrant ssh -c 'cd /vagrant && npm test (repeat as necessary)

Coding guidelines

Follow felix guidelines. This project use JSHint to validate the source code formatting with a pre commit hook: please respect that.

Contribution License Agreement

Project license: MIT

You will only Submit Contributions where You have authored 100% of the content.
You will only Submit Contributions to which You have the necessary rights. This means that if You are employed You have received the necessary permissions from Your employer to make the Contributions.
Whatever content You Contribute will be provided under the Project License.

2.1 KiB Raw Blame History