From 34daa1100e14e2856be6ab9adf3fd57e2ef4dec3 Mon Sep 17 00:00:00 2001 From: Tu-Tho Thai Date: Sun, 19 Jul 2026 15:58:46 +0200 Subject: [PATCH 1/6] addition of AI guidelins attempt for write what has been discussed previously on the use of AI --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index 582390b9f..edc8450f5 100644 --- a/README.md +++ b/README.md @@ -112,6 +112,22 @@ For new features, the decision between targetting v2.1-wip or v3.0-wip will be m _Upcoming: templates for Pull Request_ +### The use of AI in this repo 🤖 + +In this repository, the use of AI should follow these guidelines. The guiding principle is that any contributor is the ultimate reponsible for their work on NeTEx and they should be the last reviewer of any AI work before submitting it for peer-review. + +AI **can** be used for: +- Generation of code for contributors to work on the XSD by themselves, +- Analysis of any change proposed to the XSD before it is edited / commented / approved, +- Improve the general language in the documentation (i.e, anyting in `` and ``) or to check for typos in any work. + +AI **cannot** be used for: +- Committing a change in a Pull Request, i.e. the AI agent is seen as the author of the commit and not the contributor, +- Automated code review as a stand alone, i.e. without the result being proof-read by the contributor, +- Produce documentation from scratch (i.e, anyting in `` and `` should be proof-read by the contributor if it was suggested by AI). + +In case you have a GitHub Pro account, please disable the feature `Automated Copilot code review`before contributing here. + ---- ## Changelog 📰 From dfa04884ea35fb2c6930f9c97e19a744817aac1e Mon Sep 17 00:00:00 2001 From: Tu-Tho Thai Date: Sun, 19 Jul 2026 16:40:52 +0200 Subject: [PATCH 2/6] clarification on roles clarifying that only contributors can be seen as authors or co-authors of commits and pull requests --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index edc8450f5..fa4c1ba7a 100644 --- a/README.md +++ b/README.md @@ -114,7 +114,7 @@ _Upcoming: templates for Pull Request_ ### The use of AI in this repo 🤖 -In this repository, the use of AI should follow these guidelines. The guiding principle is that any contributor is the ultimate reponsible for their work on NeTEx and they should be the last reviewer of any AI work before submitting it for peer-review. +In this repository, the use of AI should follow these guidelines. The guiding principle is that any contributor is the ultimate reponsible for their work on NeTEx and they should be the last reviewer of any AI work before submitting it for peer-review; in other words, only contributors can be autors or co-authors of any change made to NeTEx. AI **can** be used for: - Generation of code for contributors to work on the XSD by themselves, @@ -122,9 +122,10 @@ AI **can** be used for: - Improve the general language in the documentation (i.e, anyting in `` and ``) or to check for typos in any work. AI **cannot** be used for: -- Committing a change in a Pull Request, i.e. the AI agent is seen as the author of the commit and not the contributor, -- Automated code review as a stand alone, i.e. without the result being proof-read by the contributor, -- Produce documentation from scratch (i.e, anyting in `` and `` should be proof-read by the contributor if it was suggested by AI). +- Committing a change in a Pull Request, i.e. the AI agent cannot be an author or co-author of any commit, +- Authoring a change, i.e. the AI agent cannot be an author or co-author of any Pull Request, +- Automated code review as a stand alone, i.e. the result of a review must be proof-read by a contributor, +- Produce documentation from scratch (i.e, anyting in `` and `` should be proof-read by a contributor if it was suggested by AI). In case you have a GitHub Pro account, please disable the feature `Automated Copilot code review`before contributing here. From 47c54e4da8257845b7e2f9aacf8674fbbe58d072 Mon Sep 17 00:00:00 2001 From: Tim Rivett <56296031+tim-rivett@users.noreply.github.com> Date: Mon, 20 Jul 2026 08:14:21 +0100 Subject: [PATCH 3/6] Update README.md --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index fa4c1ba7a..a2b483424 100644 --- a/README.md +++ b/README.md @@ -114,18 +114,18 @@ _Upcoming: templates for Pull Request_ ### The use of AI in this repo 🤖 -In this repository, the use of AI should follow these guidelines. The guiding principle is that any contributor is the ultimate reponsible for their work on NeTEx and they should be the last reviewer of any AI work before submitting it for peer-review; in other words, only contributors can be autors or co-authors of any change made to NeTEx. +In this repository, the use of AI should follow these guidelines. The guiding principle is that any contributor is ultimatly reponsible for their work on NeTEx and they should be the last reviewer of any AI work before submitting it for peer-review; in other words, only contributors can be authors or co-authors of any change made to NeTEx. AI **can** be used for: - Generation of code for contributors to work on the XSD by themselves, - Analysis of any change proposed to the XSD before it is edited / commented / approved, -- Improve the general language in the documentation (i.e, anyting in `` and ``) or to check for typos in any work. +- Improve the general language in the documentation (i.e, anything in `` and ``) or to check for typos in any work. AI **cannot** be used for: - Committing a change in a Pull Request, i.e. the AI agent cannot be an author or co-author of any commit, - Authoring a change, i.e. the AI agent cannot be an author or co-author of any Pull Request, -- Automated code review as a stand alone, i.e. the result of a review must be proof-read by a contributor, -- Produce documentation from scratch (i.e, anyting in `` and `` should be proof-read by a contributor if it was suggested by AI). +- Automated code review as a stand alone action, i.e. the result of a review must be proof-read by a contributor, +- Produce documentation from scratch (i.e, anything in `` and `` should be proof-read by a contributor if it was suggested by AI). In case you have a GitHub Pro account, please disable the feature `Automated Copilot code review`before contributing here. From a5a84ea32efe60e6c1db722a8e4677d26e37e05c Mon Sep 17 00:00:00 2001 From: Tu-Tho Thai Date: Mon, 20 Jul 2026 09:46:19 +0200 Subject: [PATCH 4/6] last typo space missing --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a2b483424..6b204f4b8 100644 --- a/README.md +++ b/README.md @@ -127,7 +127,7 @@ AI **cannot** be used for: - Automated code review as a stand alone action, i.e. the result of a review must be proof-read by a contributor, - Produce documentation from scratch (i.e, anything in `` and `` should be proof-read by a contributor if it was suggested by AI). -In case you have a GitHub Pro account, please disable the feature `Automated Copilot code review`before contributing here. +In case you have a GitHub Pro account, please disable the feature `Automated Copilot code review` before contributing here. ---- From 92f7810900b47a07bdda37581b9d7fead731eec8 Mon Sep 17 00:00:00 2001 From: Tu-Tho Thai Date: Mon, 20 Jul 2026 11:02:58 +0200 Subject: [PATCH 5/6] improve language MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit based on peer review Co-authored-by: Thibaut Barrère --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6b204f4b8..586091cbb 100644 --- a/README.md +++ b/README.md @@ -119,7 +119,7 @@ In this repository, the use of AI should follow these guidelines. The guiding pr AI **can** be used for: - Generation of code for contributors to work on the XSD by themselves, - Analysis of any change proposed to the XSD before it is edited / commented / approved, -- Improve the general language in the documentation (i.e, anything in `` and ``) or to check for typos in any work. +- Improvements to the general language in the documentation (i.e, anything in `` and ``) or to check for typos in any work. AI **cannot** be used for: - Committing a change in a Pull Request, i.e. the AI agent cannot be an author or co-author of any commit, From 8d61541eaa64f1576b76ce76c8138c016aa6df98 Mon Sep 17 00:00:00 2001 From: Tu-Tho Thai Date: Mon, 20 Jul 2026 11:03:19 +0200 Subject: [PATCH 6/6] improve language MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit based on peer review Co-authored-by: Thibaut Barrère --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 586091cbb..3717dd239 100644 --- a/README.md +++ b/README.md @@ -114,7 +114,7 @@ _Upcoming: templates for Pull Request_ ### The use of AI in this repo 🤖 -In this repository, the use of AI should follow these guidelines. The guiding principle is that any contributor is ultimatly reponsible for their work on NeTEx and they should be the last reviewer of any AI work before submitting it for peer-review; in other words, only contributors can be authors or co-authors of any change made to NeTEx. +In this repository, the use of AI should follow these guidelines. The guiding principle is that any contributor is ultimately reponsible for their work on NeTEx and they should be the last reviewer of any AI-guided work before submitting it for peer-review; in other words, only contributors can be authors or co-authors of any change made to NeTEx. AI **can** be used for: - Generation of code for contributors to work on the XSD by themselves,