| 1 | # Contributing to AG Grid Enterprise
|
| 2 |
|
| 3 | AG Grid Enterprise is copyright commercial software. If you provide a PR, you must also state that you agree to the following:
|
| 4 |
|
| 5 | # Retention of Intellectual Property Rights for AG Grid Enterprise component
|
| 6 |
|
| 7 | 1.DEFINITIONS
|
| 8 |
|
| 9 | “the Software” means the AG Grid Enterprise software as location the the repository
|
| 10 | https://github.com/ag-grid/ag-grid-enterprise.
|
| 11 |
|
| 12 | “Software Rights” means all intellectual property rights inherent in or relating to the Software,
|
| 13 | which include, but are not limited to, all copyright, patent rights, all rights in relation to registered
|
| 14 | and unregistered trademarks (including service marks) and confidential information (including trade secrets
|
| 15 | and know-how)
|
| 16 |
|
| 17 | 2.RETENTION OF INTELLECTUAL PROPERTY RIGHTS
|
| 18 |
|
| 19 | AG GRID LTD reserve ownership of all software rights for the software. Upon contributing to the software
|
| 20 | you agree to grant AG GRID LTD all software rights free of charge. You acknowledge that all software rights
|
| 21 | will belong to AG GRID LTD and will not seek payment. AG GRID LTD reserve the right to do with the software
|
| 22 | what it wishes. AG GRID LTD is under no obligation as to what it does with the contributed software.
|
| 23 |
|
| 24 | - [Question or Problem?](#question)
|
| 25 | - [Issues and Bugs](#issue)
|
| 26 | - [Feature Requests](#feature)
|
| 27 | - [Submission Guidelines](#submit)
|
| 28 | - [Coding Rules](#rules)
|
| 29 | - [Commit Message Guidelines](#commit)
|
| 30 | - [Signing the CLA](#cla)
|
| 31 |
|
| 32 | ## <a name="question"></a> Got a Question or Problem?
|
| 33 |
|
| 34 | Please, do not open issues for general support questions as we want to keep GitHub issues for bug reports and feature requests. You've got much better chances of getting your question answered on [StackOverflow](https://stackoverflow.com/questions/tagged/ag-grid) where the questions should be tagged with tag `ag-grid`.
|
| 35 |
|
| 36 | If you're using the Enterprise version of AG Grid (ag-grid-enterprise), then you should use our [Support Portal](https://ag-grid.zendesk.com/) - you'll get a much quicker response there. Please contact accounts@ag-grid.com for access.
|
| 37 |
|
| 38 | To save your and our time we will be systematically closing all the issues that are requests for general support (for AG Grid Community) and redirecting people to StackOverflow.
|
| 39 |
|
| 40 | ## <a name="issue"></a> Found a Bug?
|
| 41 |
|
| 42 | If you find a bug in the source code, you can help us by
|
| 43 | [submitting an issue](#submit-issue) to our [GitHub Repository][github].
|
| 44 |
|
| 45 | ## <a name="feature"></a> Missing a Feature?
|
| 46 |
|
| 47 | You can _request_ a new feature by [submitting an issue](#submit-issue) to our GitHub
|
| 48 | Repository.
|
| 49 |
|
| 50 | ## <a name="submit"></a> Submission Guidelines
|
| 51 |
|
| 52 | ### <a name="submit-issue"></a> Submitting an Issue
|
| 53 |
|
| 54 | Before you submit an issue, please search the issue tracker, maybe an issue for your problem already exists and the discussion might inform you of workarounds readily available.
|
| 55 |
|
| 56 | We want to fix all the issues as soon as possible, but before fixing a bug we need to reproduce and confirm it. In order to reproduce bugs we will systematically ask you to provide a minimal reproduction scenario using http://plnkr.co. Having a live, reproducible scenario gives us wealth of important information without going back & forth to you with additional questions like:
|
| 57 |
|
| 58 | - version of AG Grid Enterprise used
|
| 59 | - 3rd-party libraries and their versions
|
| 60 | - and most importantly - a use-case that fails
|
| 61 |
|
| 62 | A minimal reproduce scenario using http://plnkr.co/ allows us to quickly confirm a bug (or point out coding problem) as well as confirm that we are fixing the right problem. If plunker is not a suitable way to demonstrate the problem (for example for issues related to our npm packaging), please create a standalone git repository demonstrating the problem.
|
| 63 |
|
| 64 | We will be insisting on a minimal reproduce scenario in order to save maintainers time and ultimately be able to fix more bugs. Interestingly, from our experience users often find coding problems themselves while preparing a minimal plunk. We understand that sometimes it might be hard to extract essentials bits of code from a larger code-base but we really need to isolate the problem before we can fix it.
|
| 65 |
|
| 66 | You can file new issues by filling out our [new issue form](https://github.com/ag-grid/ag-grid-enterprise/issues/new).
|
| 67 |
|
| 68 | [github]: https://github.com/ag-grid/ag-grid-enterprise
|
| 69 | [jsfiddle]: http://jsfiddle.net
|
| 70 | [plunker]: http://plnkr.co/edit
|
| 71 | [runnable]: http://runnable.com
|
| 72 | [stackoverflow]: http://stackoverflow.com/questions/tagged/ag-grid
|