-
-
Notifications
You must be signed in to change notification settings - Fork 603
HowtoContribute
Martin@MBP edited this page Nov 23, 2013
·
14 revisions
Contributing Guidelines.
If you like to contribute, you can do this in many ways:
- Use Fancytree and send feedback.
- Create issues for bugs or features requests (see 'Report Issues').
- Have a look at the RFCs in the Wiki and provide feedback.
- Fix bugs or propose features (see 'Contribute Source Code').
- Please make sure that there is not already an existing issue for this problem/request.
Use the search function to find out.
If you have additional information, add a comment. - If it's a bug report:
Please help us to help you.- Carefully describe the required steps to reproduce the failure.
- Give additional information: what browser/version? What jQuery / jQuery UI / Fancytree version?
- What output do you see in the browser's debug console?
- Create a test case.
E.g. attach an html file, post a link to a sample page, upload a sample on http://jsfiddle.net/, ... - Maybe attach a patch file or describe a potential fix?
- If it's a feature request:
- What are you trying to accomplish?
- Why is this a cool feature? Give use cases.
- Can you propose a specification? Are there similar implementations in other projects?
Add references or screenshots if you have some.
Remember that the general API must stay generic, extensible, and consistent. How will this interfere with existing API and functionality?
- This Documentation Wiki is editable ;-)
- For small fixes, sending a simple patch may do, but
The proposed procedure is
- Fork the repository on GitHub and checkout the new fork to your computer.
- Create your feature branch (
git checkout -b my-new-feature
). - Commit your changes (
git commit -am "Added some cool feature"
). - Push to the branch (
git push origin my-new-feature
). - Create a new Pull Request.
- The style guide is basically http://contribute.jquery.org/style-guide/js/
Try to stick to the current code style. - Test the code. Add unit tests when possible.
- Does your change break any demos? Should new demos be added?
What about the documentation: should it be updated?
- For the testing framework install node.js
and grunt-cli,
then run
npm install
from the source folder. - After that you can run
grunt test
from the console in your checkout folder.
This will run the jshint checker and the unit test suite. - Note that also Travis is configured to do this for every checkin (and pull request).
- Create a pull-request.
In short
$ npm install -g grunt-cli
$ cd fancytree
$ npm install
$ grunt test
$ grunt server
$ grunt watch
Documentation Home - Project Page - Copyright (c) 2008-2022, Martin Wendt (https://wwWendt.de)