You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+12-1Lines changed: 12 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -49,6 +49,7 @@ Pull Requests
49
49
50
50
Pull requests are always invited. However, we ask that you follow these guidelines:
51
51
52
+
- It is wiser to discuss your ideas first as part of an issue before you start coding. If you omit this step and code first, be prepare to have your code receive scrutiny and be dropped.
52
53
- Users should provide a rationale for their changes. Does it improve performance? Does it add a feature? Does it improve maintainability? Does fix a bug? This must be explicitly stated as part of the pull request. Do not propose changes based on taste or intuition. We do not delegate programming to tools: that some tool suggested a code change is not reason enough to change the code.
53
54
1. When your code improves performance, please document the gains with a benchmark using hard numbers.
54
55
2. If your code fixes a bug, please be either fix a failing test, or propose a new test.
@@ -57,11 +58,21 @@ Pull requests are always invited. However, we ask that you follow these guidelin
57
58
- New features must be accompanied of new tests, in general.
58
59
- Your code should pass our continuous-integration tests. It is your responsability to ensure that your proposal pass the tests. We do not merge pull requests that would break our build.
59
60
61
+
If the benefits of your proposed code remain unclear, we may choose to discard your code: that is not an insult, we frequently discard our own code. We may also consider various alternatives and choose another path. Again, that is not an insult or a sign that you have wasted your time.
62
+
60
63
Code of Conduct
61
64
---------------
62
65
63
66
Though we do not have a formal code of conduct, we will not tolerate bullying, bigotry or
64
-
intimidation. Everyone is welcome to contribute.
67
+
intimidation. Everyone is welcome to contribute. If you have concerns, you can raise them privately with the core team members (e.g., D. Lemire, J. Keiser).
68
+
69
+
We welcome contributions from women and less represented groups. If you need help, please reach out.
70
+
71
+
Consider the following points when engaging with the project:
72
+
73
+
- We discourage arguments from authority: ideas are discusssed on their own merits and not based on who stated it.
74
+
- Be mindful that what you may view as an aggression is maybe merely a difference of opinion or a misunderstanding.
75
+
- Be mindful that a collection of small aggressions, even if mild in isolation, can become harmful.
0 commit comments