1 | ### Contributing ###
|
2 |
|
3 | Thank you for your interest in `loopback-datasource-juggler`, an open source project
|
4 | administered by StrongLoop.
|
5 |
|
6 | Contributing to `loopback-datasource-juggler` is easy. In a few simple steps:
|
7 |
|
8 | * Ensure that your effort is aligned with the project's roadmap by
|
9 | talking to the maintainers, especially if you are going to spend a
|
10 | lot of time on it.
|
11 |
|
12 | * Make something better or fix a bug.
|
13 |
|
14 | * If possible update existing or add a new unit test in the [test](tests/) directory
|
15 |
|
16 | * Adhere to code style outlined in the [Google C++ Style Guide][] and
|
17 | [Google Javascript Style Guide][].
|
18 |
|
19 | * Run lint to check adherence the style guide. Note this is also run at the end of the tests.
|
20 | ```
|
21 | npm run lint
|
22 | ```
|
23 |
|
24 | * Run tests and verify that they pass, or any that fail already failed before you introduced your change.
|
25 | ```
|
26 | npm run test
|
27 | ```
|
28 |
|
29 | * Sign the [Contributor License Agreement](https://cla.strongloop.com/agreements/strongloop/loopback-datasource-juggler)
|
30 |
|
31 | * Submit a pull request through Github.
|
32 |
|
33 |
|
34 | ### Contributor License Agreement ###
|
35 |
|
36 | ```
|
37 | Individual Contributor License Agreement
|
38 |
|
39 | By signing this Individual Contributor License Agreement
|
40 | ("Agreement"), and making a Contribution (as defined below) to
|
41 | StrongLoop, Inc. ("StrongLoop"), You (as defined below) accept and
|
42 | agree to the following terms and conditions for Your present and
|
43 | future Contributions submitted to StrongLoop. Except for the license
|
44 | granted in this Agreement to StrongLoop and recipients of software
|
45 | distributed by StrongLoop, You reserve all right, title, and interest
|
46 | in and to Your Contributions.
|
47 |
|
48 | 1. Definitions
|
49 |
|
50 | "You" or "Your" shall mean the copyright owner or the individual
|
51 | authorized by the copyright owner that is entering into this
|
52 | Agreement with StrongLoop.
|
53 |
|
54 | "Contribution" shall mean any original work of authorship,
|
55 | including any modifications or additions to an existing work, that
|
56 | is intentionally submitted by You to StrongLoop for inclusion in,
|
57 | or documentation of, any of the products owned or managed by
|
58 | StrongLoop ("Work"). For purposes of this definition, "submitted"
|
59 | means any form of electronic, verbal, or written communication
|
60 | sent to StrongLoop or its representatives, including but not
|
61 | limited to communication or electronic mailing lists, source code
|
62 | control systems, and issue tracking systems that are managed by,
|
63 | or on behalf of, StrongLoop for the purpose of discussing and
|
64 | improving the Work, but excluding communication that is
|
65 | conspicuously marked or otherwise designated in writing by You as
|
66 | "Not a Contribution."
|
67 |
|
68 | 2. You Grant a Copyright License to StrongLoop
|
69 |
|
70 | Subject to the terms and conditions of this Agreement, You hereby
|
71 | grant to StrongLoop and recipients of software distributed by
|
72 | StrongLoop, a perpetual, worldwide, non-exclusive, no-charge,
|
73 | royalty-free, irrevocable copyright license to reproduce, prepare
|
74 | derivative works of, publicly display, publicly perform,
|
75 | sublicense, and distribute Your Contributions and such derivative
|
76 | works under any license and without any restrictions.
|
77 |
|
78 | 3. You Grant a Patent License to StrongLoop
|
79 |
|
80 | Subject to the terms and conditions of this Agreement, You hereby
|
81 | grant to StrongLoop and to recipients of software distributed by
|
82 | StrongLoop a perpetual, worldwide, non-exclusive, no-charge,
|
83 | royalty-free, irrevocable (except as stated in this Section)
|
84 | patent license to make, have made, use, offer to sell, sell,
|
85 | import, and otherwise transfer the Work under any license and
|
86 | without any restrictions. The patent license You grant to
|
87 | StrongLoop under this Section applies only to those patent claims
|
88 | licensable by You that are necessarily infringed by Your
|
89 | Contributions(s) alone or by combination of Your Contributions(s)
|
90 | with the Work to which such Contribution(s) was submitted. If any
|
91 | entity institutes a patent litigation against You or any other
|
92 | entity (including a cross-claim or counterclaim in a lawsuit)
|
93 | alleging that Your Contribution, or the Work to which You have
|
94 | contributed, constitutes direct or contributory patent
|
95 | infringement, any patent licenses granted to that entity under
|
96 | this Agreement for that Contribution or Work shall terminate as
|
97 | of the date such litigation is filed.
|
98 |
|
99 | 4. You Have the Right to Grant Licenses to StrongLoop
|
100 |
|
101 | You represent that You are legally entitled to grant the licenses
|
102 | in this Agreement.
|
103 |
|
104 | If Your employer(s) has rights to intellectual property that You
|
105 | create, You represent that You have received permission to make
|
106 | the Contributions on behalf of that employer, that Your employer
|
107 | has waived such rights for Your Contributions, or that Your
|
108 | employer has executed a separate Corporate Contributor License
|
109 | Agreement with StrongLoop.
|
110 |
|
111 | 5. The Contributions Are Your Original Work
|
112 |
|
113 | You represent that each of Your Contributions are Your original
|
114 | works of authorship (see Section 8 (Submissions on Behalf of
|
115 | Others) for submission on behalf of others). You represent that to
|
116 | Your knowledge, no other person claims, or has the right to claim,
|
117 | any right in any intellectual property right related to Your
|
118 | Contributions.
|
119 |
|
120 | You also represent that You are not legally obligated, whether by
|
121 | entering into an agreement or otherwise, in any way that conflicts
|
122 | with the terms of this Agreement.
|
123 |
|
124 | You represent that Your Contribution submissions include complete
|
125 | details of any third-party license or other restriction (including,
|
126 | but not limited to, related patents and trademarks) of which You
|
127 | are personally aware and which are associated with any part of
|
128 | Your Contributions.
|
129 |
|
130 | 6. You Don't Have an Obligation to Provide Support for Your Contributions
|
131 |
|
132 | You are not expected to provide support for Your Contributions,
|
133 | except to the extent You desire to provide support. You may provide
|
134 | support for free, for a fee, or not at all.
|
135 |
|
136 | 6. No Warranties or Conditions
|
137 |
|
138 | StrongLoop acknowledges that unless required by applicable law or
|
139 | agreed to in writing, You provide Your Contributions on an "AS IS"
|
140 | BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER
|
141 | EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES
|
142 | OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, OR
|
143 | FITNESS FOR A PARTICULAR PURPOSE.
|
144 |
|
145 | 7. Submission on Behalf of Others
|
146 |
|
147 | If You wish to submit work that is not Your original creation, You
|
148 | may submit it to StrongLoop separately from any Contribution,
|
149 | identifying the complete details of its source and of any license
|
150 | or other restriction (including, but not limited to, related
|
151 | patents, trademarks, and license agreements) of which You are
|
152 | personally aware, and conspicuously marking the work as
|
153 | "Submitted on Behalf of a Third-Party: [named here]".
|
154 |
|
155 | 8. Agree to Notify of Change of Circumstances
|
156 |
|
157 | You agree to notify StrongLoop of any facts or circumstances of
|
158 | which You become aware that would make these representations
|
159 | inaccurate in any respect. Email us at callback@strongloop.com.
|
160 | ```
|
161 |
|
162 | [Google C++ Style Guide]: https://google.github.io/styleguide/cppguide.html
|
163 | [Google Javascript Style Guide]: https://google.github.io/styleguide/javascriptguide.xml
|