-
-
Notifications
You must be signed in to change notification settings - Fork 601
HowtoContribute
Martin Wendt edited this page May 26, 2013
·
14 revisions
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.
- For small fixes, sending a simple patch may do, but
The proposed procedure is
- Fork the repository on GitHub and checkout your fork to your computer.
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am "Add some feature"
) - Push to the branch (
git push origin my-new-feature
) - Create 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 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.
Documentation Home - Project Page - Copyright (c) 2008-2022, Martin Wendt (https://wwWendt.de)