From c6322d80072fe3b90317a5a3af98ae4530c866ca Mon Sep 17 00:00:00 2001 From: Andy Piper Date: Tue, 10 Mar 2026 12:53:20 +0000 Subject: [PATCH] Update contributing docs (#38125) Signed-off-by: Andy Piper --- CONTRIBUTING.md | 5 ++++- docs/DEVELOPMENT.md | 3 ++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d0b3e9eb2a6..b2f4165615d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -11,6 +11,8 @@ You can contribute in the following ways: Please review the org-level [contribution guidelines] for high-level acceptance criteria guidance and the [DEVELOPMENT] guide for environment-specific details. +You should also read the project's [AI Contribution Policy] to understand how we approach +AI-assisted contributions. ## API Changes and Additions @@ -41,7 +43,7 @@ reviewed and merged into the codebase. Our time is limited and PRs making large, unsolicited changes are unlikely to get a response. Changes which link to an existing confirmed issue, or which come -from a "help wanted" issue or other request are more likely to be reviewed. +from a "help wanted" issue or other request, are more likely to be reviewed. The smaller and more narrowly focused the changes in a PR are, the easier they are to review and potentially merge. If the change only makes sense in some @@ -89,3 +91,4 @@ and API docs. Improvements are made via PRs to the [documentation repository]. [keepachangelog]: https://keepachangelog.com/en/1.0.0/ [Mastodon documentation]: https://docs.joinmastodon.org [SECURITY]: SECURITY.md +[AI Contribution Policy]: https://github.com/mastodon/.github/blob/main/AI_POLICY.md diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index 0425f8892b6..57b992021d9 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -3,7 +3,7 @@ ## Overview Before starting local development, read the [CONTRIBUTING] guide to understand -what changes are desirable and what general processes to use. +what changes are desirable and what general processes to use. You should also read the project's [AI Contribution Policy] to understand how we approach AI-assisted contributions. ## Environments @@ -103,3 +103,4 @@ development environment configured with the software needed for this project. [GitHub Codespaces]: https://docs.github.com/en/codespaces [Homebrew]: https://brew.sh [Mastodon docs]: https://docs.joinmastodon.org/dev/setup/#working-with-emails-in-development +[AI Contribution Policy]: https://github.com/mastodon/.github/blob/main/AI_POLICY.md