README.md



Mocha needs YOU!

Did you know Mocha is a dependency of over 100,000 projects published to npm alone?

Despite this, we're currently unable to merge most pull requests due to lack of maintenance resources.

Are you interested in triaging issues or reviewing open PRs?  Have some time to hack on its codebase?  If you would like to help maintain Mocha, please contact @boneskull on Gitter.

Thank you  to all of you interested in helping.  These are Mocha's immediate needs:


Increase test coverage on Node.js and browser


Increase integration coverage for all reporters

html reporter must be tested in browser
Basic console reporters (not nyan, landing, etc.) must be tested in both browser and Node.js contexts; PhantomJS can consume all console reporters
Filesystem-based reporters must be tested in Node.js context

UPDATE - May 24 2017: Thanks to community contributions, the coverage on most reporters has increased dramatically!  The html reporter is still in dire need of coverage.
Increase coverage against all interfaces (exports in particular).  Ideally this becomes a "matrix" where we repeat sets of integration tests across all interfaces.
Refactor non-Node.js-specific tests to allow them to run in a browser context.  Node.js-specific tests include those which require the CLI or filesystem.  Most everything else is fair game.


 Review current open pull requests


We need individuals familiar with Mocha's codebase. Got questions?  Ask them in our chat room.
Pull requests must have supporting tests.  The only exceptions are pure cosmetic or non-functional changes.
Pull request contributors must sign the CLA.


Close old, inactive issues and pull requests


A bot should do this.  We need a bot. Got a bot? We now use GitHub's own probot-stale.


Triage issues


If we run into "critical" bugs, they need fixing.
"Critical" means Mocha is broken w/o workarounds for a large percentage of users
Otherwise: respond to issues, close new dupe issues, confirm bugs, ask for more info, etc.


Once we gain ground on the above items, we can work together formalize our contribution guidelines and governance.  For further info & ideas, please see our projects.

You needn't be a maintainer to submit a pull request for test coverage!

-- @boneskull, Jan 17 2016


Mocha is a simple, flexible, fun JavaScript test framework for node.js and the browser. For more information view the documentation.


Links


Changelog
Google Group
Wiki
Mocha Extensions and reporters


Backers

Become a backer and show your support to our open source project.


Sponsors

Does your company use Mocha?  Ask your manager or marketing team if your company would be interested in supporting our project.  Support will allow the maintainers to dedicate more time for maintenance and new features for everyone.  Also, your company's logo will show on GitHub and on our site--who doesn't want a little extra exposure?  Here's the info.


License

MIT