From e2917e8276ada1c2da79e0a422e55c7d941a4698 Mon Sep 17 00:00:00 2001 From: Marcos Longo <5891904+mpaiao@users.noreply.github.com> Date: Thu, 2 Apr 2026 14:39:46 -0300 Subject: [PATCH 1/4] Update contributions guidelines for the use of GenAI and AI agents in ED2 Added guidelines for the use of Generative AI in contributions. --- CONTRIBUTING.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 77d437659..4c77bbe3b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -23,6 +23,16 @@ To make sure your contributions are the most effective, please consider the foll 6. **Test, test, test**. Before submitting your contribution, make sure you test your changes. One very useful step is to compile the code and run it with comprehensive and strict debugging flags, which may help you find some code bugs at an early development stage. Please refer to our [compilation instructions](https://github.com/EDmodel/ED2/wiki/Compiler-instructions-%28aka-the-include.mk-files%29) for more details on how to build ED2 with strict compilation rules. 7. **Submit a pull request**. Once you are confident that your changes are ready, create a [pull request](https://github.com/EDmodel/ED2/pulls). Make sure to document your changes in detail, and engage with the community as you receive feedback. At this point, it is very common that people will provide you suggestions on additional modifications. Please follow up with them, and in most cases, it is possible to submit additional changes to the same pull request. Once the changes are approved, your contributions will be merged to the ED2 main branch. +## Use of Generative Artifical Intelligence (GenAI) and AI Agents + +We understand that the use of Artificial Intelligence (AI) is becoming increasingly common in code and software development. However, we ask users to read our guidelines on how to use these tools within the context of the ED2 model development. + +1. Contributors that use GenAI to help develop code must disclose its usage when submitting a pull request. Specifically, we request information such as the platform use and the extent of its use in producing the pull request (for example, specific commands versus chunks of code written with GenAI). To ensure the long-term quality of the ED2 code, we may request contributors to carry out and report additional testing, and for cases with extensive code additions or changes, we will request two approving reviews. + +2. Users must refrain from using AI agents to submit pull requests, open or comment on issues and discussion items, produce or edit Wiki content, or other features available in the ED2 model repository on GitHub. The only exception is when such usage was approved (on a case-by-case basis) by one of the core members of the ED2 model development team. Any unapproved submission to the ED2 repository will be closed and reverted. Repeated unapproved submissions will result in the submitting user being blocked. + +*Note*. The AI guidelines are inspired by similar ones proposed by @glemieux for the [FATES](https://github.com/NGEET/fates) model. + ## Additional resources - [GitHub Docs](https://docs.github.com/en). An excellent starting point for best practices when using git and GitHub for ED2 or any other project. Particularly relevant documents include (1) [how to use forks](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks), (2) [how to use branches](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches) and (3) [how to make pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests). From 6ff24ff482ef357c10c5514050fe9230011c23a2 Mon Sep 17 00:00:00 2001 From: Marcos Longo <5891904+mpaiao@users.noreply.github.com> Date: Mon, 6 Apr 2026 16:30:37 -0300 Subject: [PATCH 2/4] Update CONTRIBUTING.md Edited the contribution guidelines based on feedback from @adrifoster --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4c77bbe3b..cf2478541 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -27,7 +27,7 @@ To make sure your contributions are the most effective, please consider the foll We understand that the use of Artificial Intelligence (AI) is becoming increasingly common in code and software development. However, we ask users to read our guidelines on how to use these tools within the context of the ED2 model development. -1. Contributors that use GenAI to help develop code must disclose its usage when submitting a pull request. Specifically, we request information such as the platform use and the extent of its use in producing the pull request (for example, specific commands versus chunks of code written with GenAI). To ensure the long-term quality of the ED2 code, we may request contributors to carry out and report additional testing, and for cases with extensive code additions or changes, we will request two approving reviews. +1. Contributors that use GenAI to develop code should describe its usage when submitting a pull request. Specifically, we request information such as the platform use and the extent of its use in producing the pull request (for example, specific commands versus chunks of code written with GenAI). For cases with _extensive_ code additions/changes written with GenAI, we may request contributors to carry out and report additional testing, to ensure the the long-term quality of the ED2 code. 2. Users must refrain from using AI agents to submit pull requests, open or comment on issues and discussion items, produce or edit Wiki content, or other features available in the ED2 model repository on GitHub. The only exception is when such usage was approved (on a case-by-case basis) by one of the core members of the ED2 model development team. Any unapproved submission to the ED2 repository will be closed and reverted. Repeated unapproved submissions will result in the submitting user being blocked. From ea7bd661bcebad209268bb96be0413d7879ebf5a Mon Sep 17 00:00:00 2001 From: Marcos Longo <5891904+mpaiao@users.noreply.github.com> Date: Mon, 6 Apr 2026 16:38:23 -0300 Subject: [PATCH 3/4] Update PULL_REQUEST_TEMPLATE.md Also following @adrifoster suggestion, added some checklist in the pull request template. --- .github/PULL_REQUEST_TEMPLATE.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 48dcf4e71..b68b6b70c 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -24,6 +24,14 @@ +### Use of Generative Artificial Intelligence (GenAI) + - [ ] This commit used GenAI to produce code (beyond inline suggestions) + - [ ] Code produced by GenAI were limited (i.e., a few commands) + - [ ] Code produced by GenAI were extensive (i.e., entire subroutines) + - [ ] I have revised and tested the code produced by GenAI + + + ### Expectation of Answer Changes: From 366925cde2fefa99c3f75d5df470b664004049f7 Mon Sep 17 00:00:00 2001 From: Marcos Longo <5891904+mpaiao@users.noreply.github.com> Date: Tue, 7 Apr 2026 08:04:48 -0300 Subject: [PATCH 4/4] Update PULL_REQUEST_TEMPLATE.md Minor edits in the PR template. --- .github/PULL_REQUEST_TEMPLATE.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index b68b6b70c..178e45e69 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -30,7 +30,8 @@ - [ ] Code produced by GenAI were extensive (i.e., entire subroutines) - [ ] I have revised and tested the code produced by GenAI - + + ### Expectation of Answer Changes: