| 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
|