testit/CONTRIBUTING.md

2.3 KiB

Contributing

So you want to contribute, awesome. Thank you.

Bug reports and code and documentation patches are all welcome. You can help this project also by using the development version and by reporting any bugs you might encounter.

You may contribute in several ways like:

  • Creating new features
  • Fixing bugs
  • Improving documentation and examples
  • Translating any document here to your language

Table of contents

Developing

There is only one main source file in the project. It is the /src/index.js. The test/index.spec.js is for now the only unit test file in the project.

The dist includes the minified version of the source code.

Running tests

Run unit tests using this command:

npm test

Reporting a bug

Use the GitHub issue tracker to report any bug you find. Bugs description should include:

  • How to reproduce the bug;
  • Easy to understand title;

Would be nice to have some code showing how to reproduce the code, you may use gist or Codepen for uploading your example code.

Request a feature

Use the GitHub issue tracker to request a new feature.

Keep in mind, this is a pure javascript library, no dependencies as minimal as possible

Commit message

Commit messages should includes GitHub number reference and a imperative easy to understand sentence.

Coding style

If it is supported in all major browers without transpiling, then please use those JavaScript language features in your code, with one caveat -- readablity is king.

Currently all ES5 and ES6/ES2015 are available.

This project is linted agaist JSHint and the .jshintrc is dead-simple, and all you need to followed.

Thank you for reading this.

Hey, star this repo and/or share it with your friends.