From 77acda73d1c5e33d7c8b344d24da01a94db192d0 Mon Sep 17 00:00:00 2001 From: mingcheng Date: Thu, 18 Jun 2026 15:26:29 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20add=20guidelines=20for=20responsible=20?= =?UTF-8?q?use=20of=20AI=20tools=20=F0=9F=93=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - document AI tool usage policy in GOVERNANCE.md with disclosure requirements - add AI tools section to CONTRIBUTING.md with best practices - emphasize human review and accountability for AI-assisted contributions - maintain quality standards regardless of AI involvement Signed-off-by: mingcheng --- CONTRIBUTING.md | 9 +++++++++ GOVERNANCE.md | 10 ++++++++++ 2 files changed, 19 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2fd2e5a..970b997 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -60,6 +60,7 @@ Before you submit a PR, please take a moment to review our PR guidelines. - [Workspace Preparation](#workspace-preparation) - [Branching Strategy](#branching-strategy) - [Commit Rules](#commit-rules) +- [Use of AI Tools](#use-of-ai-tools) - [PR Description](#pr-description) - [Development Environment](#development-environment) - [Go Dependency Management](#go-dependency-management) @@ -162,6 +163,14 @@ The content of a commit should include all the changes necessary for a complete No matter the commit message or content, we place a strong emphasis on thorough code review. +### Use of AI Tools + +Dragonfly welcomes responsible use of AI tools when they help contributors work more effectively. If you use an AI tool while preparing a contribution, please make sure its purpose and scope are clear. For example, AI tools may help draft documentation, suggest code changes, summarize logs, or improve wording, but they should not replace your own understanding of the change. + +When submitting an AI-assisted PR, please mention it in the PR description. Include the tool you used and a short explanation of what it helped with. This helps reviewers understand the context of the work and keeps the review process transparent. + +Before submitting, carefully review and edit any AI-generated content. Your PR must still meet Dragonfly's quality standards, including correctness, tests where appropriate, clear documentation, and compatibility with the rest of the project. Contributors remain responsible for the accuracy and quality of everything they submit. + ### PR Description A Pull Request (PR) is the only way to make changes to the Dragonfly project files. To help reviewers understand your contribution, please provide a detailed PR description. We encourage you to follow our [PR template](./.github/PULL_REQUEST_TEMPLATE.md) when creating your pull request. diff --git a/GOVERNANCE.md b/GOVERNANCE.md index d5bf89f..b635b9b 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -27,6 +27,16 @@ We welcome contributions from everyone! If you're interested in contributing, ou We follow the [CNCF Code of Conduct](CODE_OF_CONDUCT.md) to ensure a safe and respectful environment for everyone. We expect all community members to adhere to these standards. If you witness any violations, please don't hesitate to reach out to the project maintainers or the CNCF staff. +## Use of AI Tools + +We do not oppose the use of AI tools in community work. Used responsibly, they can help contributors explore ideas, improve documentation, and speed up routine tasks. However, AI tools should support human judgment, not replace it. Community members are expected to use AI tools with a clear purpose and scope, and to make sure their work still reflects careful review and accountability. + +When AI tools are used to create or modify contributions, contributors must disclose that use in the related issue, pull request, or other community discussion. The disclosure should name the tool and briefly explain how it was used, such as drafting text, suggesting code, summarizing logs, or reviewing language. + +All AI-assisted contributions must meet the same quality standards as any other contribution. Contributors are responsible for reviewing, testing, and editing AI-generated content before submitting it. The community should not accept content that relies only on AI output without human verification, especially when accuracy, security, compatibility, or user impact is involved. + +Maintainers may periodically review how AI tools are being used in the community to make sure these principles are followed. If a contribution or community interaction does not meet these expectations, maintainers may take appropriate action, including but not limited to asking for clarification, requesting changes, issuing a warning, removing related content, or limiting the use of AI tools in that context. + ## Membership and Elections We have a structured membership system to recognize and empower active contributors. For details on how to become a Member, Approver, or Maintainer, please refer to our [Dragonfly Community Membership](COMMUNITY_MEMBERSHIP.md) and [Dragonfly Contributor Ladder](COMMUNITY_LADDER.md) documents.