Skip to content

docs(ai): introduce an AI_POLICY - #4277

Open
seanmonstar wants to merge 1 commit into
masterfrom
sean/sruvvvmkstwx
Open

seanmonstar wants to merge 1 commit into
masterfrom
sean/sruvvvmkstwx

Conversation

@seanmonstar

Copy link
Copy Markdown
Member

For better or worse, LLMs are upon us. We are getting many more contributions using them. We may have personal preferences on how to use them ourselves. But best to at least define a policy for contributing, to have something to point to, and to try to align best practices.

This takes a balanced view, recognizing that policing usage is a recipe for sad times. Intent, understanding, and respect are what matters most.

Feedback welcome. Rendered

Comment thread docs/AI_POLICY.md Resolved
@seanmonstar
seanmonstar requested a review from a team November 18, 2026 16:12
Comment thread docs/AI_POLICY.md

## Code must be understood

Creators of a pull request should try to understand the code submitted. We recognize that even before LLMs, various experience levels meant differing levels of understanding of the programmer. Still, intent matters.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Feels like should try is too ambiguous here. Perhaps it's better to write it as understand to a certain extent/degree instead?

It also kinda contradicts L7 above.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I originally wanted to insist authors must understand what they wrote, but I had a conversation with someone where we were checking our expectations versus what about before LLMs, and a new/junior dev could try to contribute without fully understanding all that they changed.

But anyone merging it has to understand.


Still, if it feels too weak, I can think about a refinement.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants