From 023842f39e03b40b97ce6d61fce6c8216430ac63 Mon Sep 17 00:00:00 2001 From: Preet Kalra Date: Sat, 1 Aug 2026 13:20:37 +0530 Subject: [PATCH 1/6] Add CONTRIBUTING.md with contribution guidelines --- CONTRIBUTING.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 000000000..bd404fdc3 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,39 @@ +# Contributing + +Thank you for your interest in contributing to the HSF website. + +Contributions of all sizes are welcome, including documentation improvements, typo fixes, bug fixes, and new content. For significant changes or new features, please open an issue first to discuss your proposal before starting work. + +## AI-assisted contributions + +AI-assisted contributions are welcome. If you use generative AI tools (such as ChatGPT, GitHub Copilot, or Claude) while preparing your contribution, please: + +- disclose the use of AI in your pull request when appropriate; +- review and understand all AI-generated content before submitting it; +- verify that the proposed changes are correct and appropriate for the project; +- remain fully responsible for the content of your contribution. + +## Contributor etiquette + +To help keep reviews efficient and productive, please: + +- keep pull requests focused on a single logical change; +- write clear commit messages and pull request descriptions; +- be respectful and constructive in discussions; +- assume good intentions and collaborate in a friendly manner. + +## Before opening a pull request + +Before submitting a pull request, please ensure that: + +- your changes have been reviewed by you; +- your pull request description clearly explains the purpose of the changes; +- your contribution does not introduce unintended modifications. + +## Additional guidance + +Practical information on editing the website, running a local preview, and contributing content is available in the website contribution guide: + +https://hepsoftwarefoundation.org/howto-website.html + +Thank you for helping improve the HSF website. \ No newline at end of file From 7a1b6f6d061f7195ef0bbb3cf2d399c8508203af Mon Sep 17 00:00:00 2001 From: Claire Antel Date: Fri, 16 Oct 2026 14:41:09 +0200 Subject: [PATCH 2/6] refine CONTRIBUTING.md More focus on simple due diligence, advertise standardised ai declarations, sections on PR rejection reasons --- CONTRIBUTING.md | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bd404fdc3..33882ea55 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -4,15 +4,16 @@ Thank you for your interest in contributing to the HSF website. Contributions of all sizes are welcome, including documentation improvements, typo fixes, bug fixes, and new content. For significant changes or new features, please open an issue first to discuss your proposal before starting work. -## AI-assisted contributions +## Due diligence -AI-assisted contributions are welcome. If you use generative AI tools (such as ChatGPT, GitHub Copilot, or Claude) while preparing your contribution, please: - -- disclose the use of AI in your pull request when appropriate; -- review and understand all AI-generated content before submitting it; +Any contribution should be fully understood by you, so, please: +- review and understand all content before submitting it - AI generated or not; +- helpfully disclose the use of AI in your pull request when appropriate; - verify that the proposed changes are correct and appropriate for the project; - remain fully responsible for the content of your contribution. +TIP: We generally recommend making use of standardised AI declarations at . + ## Contributor etiquette To help keep reviews efficient and productive, please: @@ -30,10 +31,16 @@ Before submitting a pull request, please ensure that: - your pull request description clearly explains the purpose of the changes; - your contribution does not introduce unintended modifications. +## A PR may immediately be rejected if... + +- the PR description provides no motivation for the changes; +- it unnecessarily implements too many changes in one go: As a single large PR or a flood of small PRs; +- it appear to be generated solely by AI with little or no human contributor oversight. + ## Additional guidance Practical information on editing the website, running a local preview, and contributing content is available in the website contribution guide: -https://hepsoftwarefoundation.org/howto-website.html + -Thank you for helping improve the HSF website. \ No newline at end of file +Thank you for helping improve the HSF website. From 71b30f7ad70bf2a61741a5a52aeb4d0d8636ffb2 Mon Sep 17 00:00:00 2001 From: Caterina Date: Fri, 16 Oct 2026 13:54:18 +0100 Subject: [PATCH 3/6] Update CONTRIBUTING.md --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 33882ea55..127a60a5a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -12,7 +12,7 @@ Any contribution should be fully understood by you, so, please: - verify that the proposed changes are correct and appropriate for the project; - remain fully responsible for the content of your contribution. -TIP: We generally recommend making use of standardised AI declarations at . +TIP: We generally recommend making use of a standardised AI declaration such as the one at , and paste the content of the declaration at the end of your pull request. ## Contributor etiquette From 5e395b0398887ad6dc37a37315a14d8f1f14dd17 Mon Sep 17 00:00:00 2001 From: Eduardo Rodrigues Date: Fri, 16 Oct 2026 15:58:04 +0200 Subject: [PATCH 4/6] Clarify AI disclosure in contribution guidelines --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 127a60a5a..4def1fdc2 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,7 +8,7 @@ Contributions of all sizes are welcome, including documentation improvements, ty Any contribution should be fully understood by you, so, please: - review and understand all content before submitting it - AI generated or not; -- helpfully disclose the use of AI in your pull request when appropriate; +- helpfully disclose the use of AI in your pull request (PR) when appropriate; - verify that the proposed changes are correct and appropriate for the project; - remain fully responsible for the content of your contribution. From 2bcd6c3cd813fa0f290de18f5f7d86533b1a7563 Mon Sep 17 00:00:00 2001 From: Eduardo Rodrigues Date: Fri, 16 Oct 2026 15:59:10 +0200 Subject: [PATCH 5/6] Refine language in CONTRIBUTING.md for clarity Updated language for consistency and clarity in the CONTRIBUTING.md file. --- CONTRIBUTING.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4def1fdc2..d5ea95c85 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -12,23 +12,23 @@ Any contribution should be fully understood by you, so, please: - verify that the proposed changes are correct and appropriate for the project; - remain fully responsible for the content of your contribution. -TIP: We generally recommend making use of a standardised AI declaration such as the one at , and paste the content of the declaration at the end of your pull request. +TIP: We generally recommend making use of a standardised AI declaration such as the one at , and paste the content of the declaration at the end of your PR. ## Contributor etiquette To help keep reviews efficient and productive, please: -- keep pull requests focused on a single logical change; -- write clear commit messages and pull request descriptions; +- keep PRs focused on a single logical change; +- write clear commit messages and PR descriptions; - be respectful and constructive in discussions; - assume good intentions and collaborate in a friendly manner. ## Before opening a pull request -Before submitting a pull request, please ensure that: +Before submitting a PR, please ensure that: - your changes have been reviewed by you; -- your pull request description clearly explains the purpose of the changes; +- your description clearly explains the purpose of the changes; - your contribution does not introduce unintended modifications. ## A PR may immediately be rejected if... From eeb92d71186727167d247822ee7a9c6b28a79dba Mon Sep 17 00:00:00 2001 From: Claire Antel Date: Fri, 16 Oct 2026 16:20:59 +0200 Subject: [PATCH 6/6] fix grammar Co-authored-by: Eduardo Rodrigues --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d5ea95c85..74cb93420 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -35,7 +35,7 @@ Before submitting a PR, please ensure that: - the PR description provides no motivation for the changes; - it unnecessarily implements too many changes in one go: As a single large PR or a flood of small PRs; -- it appear to be generated solely by AI with little or no human contributor oversight. +- it appears to be generated solely by AI with little or no human contributor oversight. ## Additional guidance