public/assets/Chart.js-2-1-3/CONTRIBUTING.md

   1 Contributing to Chart.js
   2 ========================
   3
   4 Contributions to Chart.js are welcome and encouraged, but please have a look through the guidelines in this document before raising an issue, or writing code for the project.
   5
   6
   7 Using issues
   8 ------------
   9
  10 The [issue tracker](https://github.com/chartjs/Chart.js/issues) is the preferred channel for reporting bugs, requesting new features and submitting pull requests.
  11
  12 If you're suggesting a new chart type, please take a look at [writing new chart types](https://github.com/chartjs/Chart.js/blob/master/docs/07-Advanced.md#writing-new-chart-types) in the documentation or consider [creating a plugin](https://github.com/chartjs/Chart.js/blob/master/docs/07-Advanced.md#creating-plugins).
  13
  14 To keep the library lightweight for everyone, it's unlikely we'll add many more chart types to the core of Chart.js, but issues are a good medium to design and spec out how new chart types could work and look.
  15
  16 Please do not use issues for support requests. For help using Chart.js, please take a look at the [`chartjs`](http://stackoverflow.com/questions/tagged/chartjs) tag on Stack Overflow.
  17
  18
  19 Reporting bugs
  20 --------------
  21
  22 Well structured, detailed bug reports are hugely valuable for the project.
  23
  24 Guidlines for reporting bugs:
  25
  26  - Check the issue search to see if it has already been reported
  27  - Isolate the problem to a simple test case
  28  - Provide a demonstration of the problem on [JS Bin](http://jsbin.com) or similar
  29
  30 Please provide any additional details associated with the bug, if it's browser or screen density specific, or only happens with a certain configuration or data.
  31
  32
  33 Local development
  34 -----------------
  35
  36 Run `npm install` to install all the libraries, then run `gulp dev --test` to build and run tests as you make changes.
  37
  38
  39 Pull requests
  40 -------------
  41
  42 Clear, concise pull requests are excellent at continuing the project's community driven growth. But please review [these guidelines](https://github.com/blog/1943-how-to-write-the-perfect-pull-request) and the guidelines below before starting work on the project.
  43
  44 Be advised that **Chart.js 1.0.2 is in feature-complete status**. Pull requests adding new features to the 1.x branch will be disregarded.
  45
  46 Guidelines:
  47
  48  - Please create an issue first:
  49    - For bugs, we can discuss the fixing approach
  50    - For enhancements, we can discuss if it is within the project scope and avoid duplicate effort
  51  - Please make changes to the files in [`/src`](https://github.com/chartjs/Chart.js/tree/master/src), not `Chart.js` or `Chart.min.js` in the repo root directory, this avoids merge conflicts
  52  - Tabs for indentation, not spaces please
  53  - If adding new functionality, please also update the relevant `.md` file in [`/docs`](https://github.com/chartjs/Chart.js/tree/master/docs)
  54  - Please make your commits in logical sections with clear commit messages
  55
  56 Joining the project
  57 -------------
  58  - Active committers and contributors are invited to introduce yourself and request commit access to this project.  Please send an email to hello@nickdownie.com or file an issue.
  59  - We have a very active Slack community that you can join at https://chartjs-slack-automation.herokuapp.com. If you think you can help, we'd love to have you!
  60
  61 License
  62 -------
  63
  64 By contributing your code, you agree to license your contribution under the [MIT license](https://github.com/chartjs/Chart.js/blob/master/LICENSE.md).