Skip to content

Latest commit

 

History

History
46 lines (32 loc) · 2.12 KB

CONTRIBUTING.md

File metadata and controls

46 lines (32 loc) · 2.12 KB

Contributing

Welcome! Thanks for your interest in contributing to QUnit. This document is intended to help make your experience smooth and enjoyable. If you feel anything should be added or clarified, definitely let us know.

If this is your first time contributing to Open Source Software in general, then you might want to start by looking at jQuery's excellent contributing guide.

Contributor License Agreement

As a first step, in order to contribute to QUnit, you'll need to sign the JS Foundation's CLA for QUnit.

Development

In order to contribute any changes to the QUnit repo, you'll need to first fork the repository. After that you should create a branch for the change and commit any relevant changes.

Workflows for documentation or code changes are outlined below.

Code

For code changes, you'll need to have node.js installed on your machine.

Install dependencies in the repository via npm install. Make your code changes and run npm test to lint and test the changes. To run tests as you make changes to the code base, you can use npm run dev which will rebuild QUnit and run tests any time you make a change to the source code.

Almost all code changes should be accompanied by new unit tests to verify the changes being made. Assuming all existing and any new tests are passing, make a commit, push it to GitHub and create a pull request. Be sure to include some background for the change in the commit message and the message Fixes #nnn, referring to the issue number you're addressing.

Documentation

The API documentation for QUnit lives in the docs directory of this repository. For the rest of the QUnit website, see the qunitjs.com repo.

The API documentation in this repo uses jekyll. If you make a change to the documentation, use jekyll serve to verify how the change will look when deployed to the website.