Rationale
There are more frequent pull requests that have been mostly generated by AI, where it’s not disclosed and the author may not fully understand what they are contributing.
Code review and maintenance has always been a big bottleneck. With AI contributions that the contributor does not fully understand themselves, this puts an even bigger burden on reviewers. Worst case, reviewers are effectively talking to an AI through a game of telephone.
There is value in educating new developers to grow the project, also when it would have been faster for the reviewer to make the changes themselves (with or without AI). For this reason, reviewers should know if they are working together with a human, so they can decide when they want to make this effort.
On the other hand, AI assisted code review and checks based on our guidelines on developers.blender.org have the potential to lighten the burden for reviewers, or help fix bugs and improve stability. So there are ways contributors can help make this a positive for the project.
Example Policies
Proposed Policy
This is based on the Fedora policy (CC BY-SA 4.0) with some things that are not relevant to Blender left out, and the third paragraph added by me. The wording is more formal than our other guidelines on developer.blender.org, and this could be tweaked. But it’s a starting point for discussion.
This a proposed policy for Blender development, regarding code and issues on projects.blender.org and related documents like code.blender.org or devtalk.blender.org posts. The wording effectively covers documentation and translation as well.
Generative AI for images and assets are not part of this, It makes more sense to use art created using Blender and other open source creative tools, and copyright concerns seem harder to verify than code.
You may use AI assistance for contributing to Blender development with code and text, as long as you follow the principles described below. You should not contribute AI generated images and 3D assets. The principles apply to the entirety of contributions including code, images and other files.
Accountability: You must take the responsibility for your contribution. Contributing to Blender means vouching for the quality, license compliance, and utility of your submission. All contributions, whether from a human author or assisted by large language models (LLMs) or other generative AI tools, must meet the project’s standards for inclusion. The contributor is always the author and is fully accountable for the entirety of these contributions.
You must understand and manually review code, designs, bug reports, descriptions and comments you submit, and carefully test the resulting functionality and fixes for code contributions. Your own effort should provide significant value beyond the output of tools.
Transparency: You must disclose the use of AI tools when a significant part of your contribution, descriptions or comments are taken from a tool. You should disclose the other uses of AI tools, where it might be useful. Routine use of assistive tools for e.g. correcting grammar, spelling or translation does not require disclosure.
Disclosures are made where authorship is normally indicated. For contributions tracked in git, use anAssisted-by:commit message trailer. For other contributions, disclosure may be a note in the design document, issue description or comment.
Decision Making: AI tools may be used to assist human reviewers by providing analysis and suggestions. You must not use AI as the sole or final arbiter in making a substantive or subjective judgment on a contribution.
If reviewers strongly suspect a contribution does not follow this policy, they reserve the right to close the pull request or issue without review.
Proposed Policy (v2)
With advances in AI tools it has become easier to generate and contribute code, documentation and designs. However quality is often poor, and reviewers and maintainers already lack the time to handle all contributions.
For the health of the project, contributions must follow these rules, and (with few exceptions) these guidelines too. This policy applies to code, documentation and design contributions for Blender development, as well as bug reports and comments. It does not apply to Blender extensions.
If reviewers strongly suspect a contribution does not follow this policy, they reserve the right to close the pull request or issue without review.
Rules
You must take the responsibility for your contribution. Contributing to Blender means vouching for the quality, license compliance, and utility of your submission. All contributions, whether from a human author or tool generated, must meet the project’s standards for inclusion. The contributor is always the author and is fully accountable for the entirety of these contributions.
You must understand and manually review code, designs, bug reports, descriptions and comments you submit, and carefully test the resulting functionality and fixes for code contributions. Do not pass along tool generated output without reading or understanding it yourself.
You must disclose the use of AI tools when a significant part of your contribution, descriptions or comments are taken from them. Add an
Assisted-by:trailer in commit messages and pull request descriptions. Only humans can be commit authors or listed asCo-authored-by:.Guidelines
Your own effort should provide significant value beyond the output of tools. If you are merely acting as an intermediary between the tool and reviewer, this is likely a waste of the reviewer’s time . They could have been using the tool directly or could have chosen different priorities.
Primarily think of tools as a way to improve the quality of your contributions and the Blender project, rather than a way to work faster or go beyond your expertise. If a tool does part of the work for you, that means you have more time for careful testing, and thinking through design and corner cases. Additionally, these tools are able to perform in depth code reviews. For this reason, the quality bar for AI generated contributions is higher than other contributions.
Write your own descriptions and comments (even if your English is not perfect). The developer community needs to have human to human interactions and build trust, and this is impossible without talking to a real person. This also helps you to think through things.
Do not solve Good First Issues with AI. These are meant as a learning experience and require time investment from reviewers, which is wasted on AI.
If generated code is not clearly an extension to or refactoring of existing code, expect extra scrutiny and potential rejection due to copyright risk.
