1 | # CONTRIBUTING
|
2 |
|
3 | We welcome contributions from everyone!
|
4 |
|
5 | ## Getting Started
|
6 |
|
7 | Make sure you have Node.js 8 or higher and npm installed.
|
8 |
|
9 | 1. Fork this repository and clone your fork
|
10 | 1. Install dependencies: `npm install`
|
11 | 1. Run a development server: `npm start`
|
12 |
|
13 | ### Making Changes
|
14 |
|
15 | Refer to the [video.js plugin conventions][conventions] for more detail on best practices and tooling for video.js plugin authorship.
|
16 |
|
17 | When you've made your changes, push your commit(s) to your fork and issue a pull request against the original repository.
|
18 |
|
19 | ### Running Tests
|
20 |
|
21 | Testing is a crucial part of any software project. For all but the most trivial changes (typos, etc) test cases are expected. Tests are run in actual browsers using [Karma][karma].
|
22 |
|
23 | - In all available and supported browsers: `npm test`
|
24 | - In a specific browser: `npm run test:chrome`, `npm run test:firefox`, etc.
|
25 | - While development server is running (`npm start`), navigate to [`http://localhost:9999/test/`][local]
|
26 |
|
27 |
|
28 | [karma]: http://karma-runner.github.io/
|
29 | [local]: http://localhost:9999/test/
|
30 | [conventions]: https://github.com/videojs/generator-videojs-plugin/blob/master/docs/conventions.md
|