|
1 | 1 | # Policy on usage of Artifical Intelligence and other tools |
2 | 2 |
|
| 3 | +## Read this first |
| 4 | + |
| 5 | +The most important rule: Inform about it! |
| 6 | + |
| 7 | +If you've spent hours, perhaps a full day of your time writing up a |
| 8 | +pull request, then I sort of owe you something. I should spend some |
| 9 | +of my time looking through the submission carefully, and if nothing |
| 10 | +else, I owe to be polite, respectful and guide you in the right |
| 11 | +direction or give a good explanation for why I think your pull request |
| 12 | +is pulling the project in the wrong direction. A human being have |
| 13 | +feelings, I should be careful not to hurt your feelings. |
| 14 | + |
| 15 | +At the other hand, perhaps you've spent 30 seconds either doing `ruff |
| 16 | +check --fix ; gh pr create` or telling Claude to check what went wrong |
| 17 | +in the logs and submit a bugfix upstream. Do I still owe |
| 18 | +you to spend time looking through the submission carefully and |
| 19 | +spending time being polite and caring about your feelings? |
| 20 | + |
| 21 | +Perhaps your pull request is just one out of many such "drive-by pull |
| 22 | +requests". It doesn't scale for a maintainer to spent lots of time on |
| 23 | +each such pull request. I should just accept or decline such requests |
| 24 | +rapidly with minimum effort. |
| 25 | + |
| 26 | +So it all boils down to this: Be honest about tool usage! |
| 27 | + |
3 | 28 | ## Background |
4 | 29 |
|
5 | | -From time to time I do get pull requests where the author has done |
6 | | -little else than running some tool on the code and submitting it as a |
7 | | -pull request. Those pull requests may have value to the project, but |
8 | | -it's dishonest to not be transparent about it; teaching me how to run |
9 | | -the tool and integrating it into the CI workflow may have a bigger |
10 | | -value than the changes provided by the tool. Recently I've also |
11 | | -started receiving pull requests with code changes generated by AI (and |
12 | | -I've seen people posting screenshots of simple questions and answers |
13 | | -from ChatGPT in forum discussions, without contributing anything else). |
| 30 | +The "30 second effort pull request" mentioned above may have value to |
| 31 | +the project, but it's dishonest to not be transparent about it. |
| 32 | +Sometimes, teaching me how to run the tool and integrating it into the |
| 33 | +CI workflow may have a bigger value than the changes provided by the |
| 34 | +tool. |
14 | 35 |
|
15 | 36 | Starting in 2025-11, I've spent quite some time testing Claude. I'm |
16 | 37 | positively surprised, it's doing a much better job than what I had |
17 | 38 | expected. The AI may do things a lot faster, smarter and better than |
18 | 39 | a good coder. Sometimes. Other times it may spend a lot of "tokens" |
19 | | -and a long time coming up with sub-optimal solutions, or even |
20 | | -solutions that doesn't work at all. Perhaps at some time in the near |
21 | | -future the AI will do the developer profession completely obsoleted - |
22 | | -but as of 2026-02, my experiences is that the AI performs best when |
23 | | -being "supervised" and "guided" by a good coder knowing the project. |
| 40 | +and a long time coming up with sub-optimal or really bad solutions. |
| 41 | + |
| 42 | +Perhaps at some time in the near future the AI will do the developer |
| 43 | +profession completely obsoleted - but as of 2026-02, my experiences is |
| 44 | +that the AI performs best when being "supervised" and "guided" by a |
| 45 | +good coder knowing the project. |
| 46 | + |
| 47 | +## Bugfixes are (most often) welcome |
| 48 | + |
| 49 | +Over the past month, playing with a "max" subscription with Claude, |
| 50 | +I've made it into a rule that when I stumble upon some weird bug in |
| 51 | +some software or libraries I'm using or dependent on, I always ask |
| 52 | +Claude to analyze the bug, check the outstanding issues in the |
| 53 | +project, either create a new issue or consider if there is anything of |
| 54 | +value to add to an existing issue, and come up with a pull-request. Being a bit aware of the |
24 | 55 |
|
25 | | -## The rules |
| 56 | +## General rules |
26 | 57 |
|
27 | 58 | * Do **respect the maintainers time**. If/when the maintainer gets |
28 | 59 | overwhelmed by pull requests of questionable quality or pull |
|
0 commit comments