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
**We do not accept pull requests that are primarily or substantially generated by AI tools** (ChatGPT, Copilot, etc.). All contributions must be written and understood by human contributors.
94
93
95
-
-**JIRA LINK**
94
+
##### Why This Policy Exists
96
95
97
-
- Convenient link to the associated JIRA ticket.
96
+
Many MongoDB libraries are foundational tools used in production systems worldwide. The nature of these libraries requires:
98
97
99
-
-**Summary**
98
+
-**Absolute correctness**: We have no margin for "generally right" code. Subtle bugs can cause data corruption, security vulnerabilities, or silent failures that only appear under specific conditions.
100
99
101
-
- Small blurb on why this is needed. The JIRA task should have
102
-
the more in-depth description, but this should still, at a
103
-
high level, give anyone looking an understanding of why the
104
-
PR has been checked in.
100
+
-**Deep domain expertise**: MongoDB's wire protocol, BSON specification, connection pooling, authentication mechanisms, and concurrency patterns require an understanding that AI cannot reliably provide.
105
101
106
-
-**Changes in this PR**
102
+
-**Long-term maintainability**: Contributors need to be able to explain *why* code is written a certain way, explain design decisions, and be available to iterate on their contributions.
107
103
108
-
- The explicit code changes that this PR is introducing. This
109
-
should be more specific than just the task name. (Unless the
110
-
task name is very clear).
104
+
-**Security responsibility**: Authentication, credential handling, and TLS implementation cannot be left to probabilistic code generation.
111
105
112
-
-**Test Plan**
106
+
##### What This Means for Contributors
113
107
114
-
- Everything needs a test description. Describe what you did
115
-
to validate your changes actually worked; if you did
116
-
nothing, then document you did not test it. Aim to make
117
-
these steps reproducible by other engineers, specifically
118
-
with your primary reviewer in mind.
108
+
**Required:**
119
109
120
-
-**Screenshots**
110
+
- Full understanding of every line of code you submit
111
+
- Ability to explain and defend your implementation choices
112
+
- Willingness to iterate and maintain your contributions
121
113
122
-
- Any images that provide more context to the PR. Usually,
123
-
these just coincide with the test plan.
114
+
**Encouraged:**
124
115
125
-
-**Callouts or follow-up items**
116
+
- Using AI assistants as learning tools to understand concepts
117
+
- IDE autocomplete features that suggest standard patterns
118
+
- AI help for brainstorming approaches (but write the code yourself)
126
119
127
-
- This is a good place for identifying "to-dos" that you've
128
-
placed in the code (Must have an accompanying JIRA Ticket).
129
-
- Potential bugs that you are unsure how to test in the code.
130
-
- Opinions you want to receive about your code.
120
+
**Not allowed:**
121
+
122
+
- Submitting PRs generated solely by AI tools
123
+
- Copy-pasting AI-generated code without full understanding
124
+
125
+
##### Disclosure
126
+
127
+
If you used AI assistance in any way during your contribution, please disclose what the AI assistant was used for in your PR description. When in doubt, mention it.
128
+
129
+
##### Questions?
130
+
131
+
If you're unsure whether your contribution complies with this policy, please ask in an issue before submitting a PR. We're happy to guide contributors toward successful contributions.
132
+
133
+
---
134
+
135
+
*This policy helps us maintain the reliability, security, and trustworthiness that production applications depend on. Thank you for understanding and for contributing thoughtfully to PyMongo.*
0 commit comments