AutorÃa | Ultima modificación | Ver Log |
Contributing to bootstrap-fileinput===================================Looking to contribute something to bootstrap-fileinput? **Here's how you can help.**Please take a moment to review this document in order to make the contributionprocess easy and effective for everyone involved.Following these guidelines helps to communicate that you respect the time ofthe developers managing and developing this open source project. In return,they should reciprocate that respect in addressing your issue or assessingpatches and features.Using the issue tracker-----------------------When [reporting bugs][reporting-bugs] or[requesting features][requesting-features], the[issue tracker on GitHub][issue-tracker] is the recommended channel to use.The issue tracker **is not** a place for support requests. Refer the[plugin documentation](http://plugins.krajee.com/file-input),[plugin demos](http://plugins.krajee.com/file-input/demo), and / or refer to the[webtips Q & A forum](http://webtips.krajee.com/questions) which are the better places to get help.Reporting bugs with bootstrap-fileinput---------------------------------------We really appreciate clear bug reports that _consistently_ show an issue_within bootstrap-fileinput_.The ideal bug report follows these guidelines:1. **Use the [GitHub issue search][issue-search]** — Check if the issuehas already been reported.2. **Check if the issue has been fixed** — Try to reproduce the problemusing the code in the `master` branch.3. **Isolate the problem** — Try to create an[isolated js fiddle][isolated-case] that consistently reproduces the problem.Please try to be as detailed as possible in your bug report, especially if anisolated test case cannot be made. Some useful questions to include the answerto are:- What steps can be used to reproduce the issue?- What is the bug and what is the expected outcome?- What browser(s) and Operating System have you tested with?- Does the bug happen consistently across all tested browsers?- What version of jQuery are you using? And what version of bootstrap-fileinput?- Are you using bootstrap-fileinput with other plugins?All of these questions will help others fix and identify any potential bugs.Requesting features in bootstrap-fileinput------------------------------------------Before starting work on a major feature for bootstrap-fileinput, **read the[documentation](http://plugins.krajee.com/file-input) first** or you may risk spending a considerable amount oftime on something which the project developers are not interested in bringing into the project.### Submitting a pull requestWe use GitHub's pull request system for submitting patches. Here are someguidelines to follow when creating the pull request for your fix.1. Make sure to create a ticket for your pull request. This will serve as thebug ticket, and any discussion about the bug will take place there. Your pullrequest will be focused on the specific changes that fix the bug.2. Make sure to reference the ticket you are fixing within your pull request.This will allow us to close off the ticket once we merge the pull request, orfollow up on the ticket if there are any related blocking issues.3. Explain why the specific change was made. Not everyone who is reviewing yourpull request will be familiar with the problem it is fixing.4. Run your tests first. If your tests aren't passing, the pull request won'tbe able to be merged. If you're breaking existing tests, make sure that youaren't causing any breaking changes.5. Only include source changes. While it's not required, only including changesfrom the `src` directory will prevent merge conflicts from occuring. Makingthis happen can be as a simple as not committing changes from the `dist`directory.By following these steps, you will make it easier for your pull request to bereviewed and eventually merged.Triaging issues and pull requests---------------------------------Anyone can help the project maintainers triage issues and review pull requests.### Handling new issuesbootstrap-fileinput regularly receives new issues which need to be tested and organized.When a new issue that comes in that is similar to another existing issue, itshould be checked to make sure it is not a duplicate. Duplicates issues shouldbe marked by replying to the issue with "Duplicate of #[issue number]" where`[issue number]` is the url or issue number for the existing issue. This willallow the project maintainers to quickly close off additional issues and keepthe discussion focused within a single issue.If you can test issues that are reported to bootstrap-fileinput that contain test cases andconfirm under what conditions bugs happen, that will allow others to identifywhat causes a bug quicker.### Reviewing pull requestsIt is very common for pull requests to be opened for issues that contain a clearsolution to the problem. These pull requests should be rigorously reviewed bythe community before being accepted. If you are not sure about a piece ofsubmitted code, or know of a better way to do something, do not hesitate to makea comment on the pull request.### Reviving old ticketsIf you come across tickets which have not been updated for a while, you areencouraged to revive them. While this can be as simple as saying `:+1:`, it isbest if you can include more information on the issue. Common bugs and featurerequests are more likely to be fixed, whether it is by the community or thedevelopers, so keeping tickets up to date is encouraged.Licensing---------It should also be made clear that **all code contributed to bootstrap-fileinput** must belicensable under the [BSD-3 license][licensing]. Code that cannot be releasedunder this license **cannot be accepted** into the project.[isolated-case]: https://jsfiddle.net/[issue-search]: https://github.com/kartik-v/bootstrap-fileinput/search?q=&type=Issues[issue-tracker]: https://github.com/kartik-v/bootstrap-fileinput/issues[licensing]: https://github.com/kartik-v/bootstrap-fileinput/blob/master/LICENSE.md[reporting-bugs]: #reporting-bugs-with-bootstrap-fileinput[requesting-features]: #requesting-features-in-bootstrap-fileinput