Skip to content

Commit 7327c28

Browse files
committed
strengthen guidelines on AI slop
1 parent db992c7 commit 7327c28

4 files changed

Lines changed: 15 additions & 6 deletions

File tree

.github/ISSUE_TEMPLATE/content.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Section: (eg '02-foundations/03-security-principles')
1919

2020
Please make sure you have:
2121

22-
- [ ] read the [contribution guide](../contributing.md) and agree to the [Code of Conduct](../code_of_conduct.md)
22+
- [ ] read the [contribution guide](../blob/main/contributing.md) and agree to the [Code of Conduct](../blob/main/code_of_conduct.md)
2323
- [ ] not used agentic or generative AI in creating this issue
2424

2525
**Context**:

.github/ISSUE_TEMPLATE/request.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Section: (eg '02-foundations/03-security-principles')
1919

2020
Please make sure you have:
2121

22-
- [ ] read the [contribution guide](../contributing.md) and agree to the [Code of Conduct](../code_of_conduct.md)
22+
- [ ] read the [contribution guide](../blob/main/contributing.md) and agree to the [Code of Conduct](../blob/main/code_of_conduct.md)
2323
- [ ] not used agentic or generative AI in creating this issue
2424

2525
**Context**:

.github/pull_request_template.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ for inclusion in the change log
1717

1818
Thanks for submitting a pull request, please make sure:
1919

20-
- [ ] content meets the [license](../license.txt) for this project
21-
- [ ] you have read the [contribution guide](../contributing.md) and agree to the [Code of Conduct](../code_of_conduct.md)
22-
- [ ] any use of AI has been declared in this pull request
20+
- [ ] content meets the [license](../blob/main/license.txt) for this project
21+
- [ ] you have read the [contribution guide](../blob/main/contributing.md) and agree to the [Code of Conduct](../blob/main/code_of_conduct.md)
22+
- [ ] any [use of AI](../blob/main/contributing.md#use-of-ai) has been declared in this pull request
2323

2424
**Other info** :
2525

contributing.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ Contributors can [make suggestions][issues] and provide changes via a [pull requ
1414

1515
Feel free to discuss topics in the [project wiki][wiki] and create new discussions.
1616

17+
Note that you **must** follow the rules for any [use of AI](#use-of-ai).
18+
1719
### Ground rules
1820

1921
When contributing:
@@ -114,19 +116,26 @@ The pull requests have checks applied to them:
114116
2. Markdown lint that ensures the markdown is consistent and valid
115117
3. Spell checker; new words that are not recognized should be added to `.wordlist.txt`
116118

119+
Note that you **must** follow the rules for any [use of AI](#use-of-ai) in the pull request.
120+
117121
### Use of AI
118122

119-
The Developer Guide is a documentation project, and so the content must be accurate, informative and concise.
123+
The Developer Guide is a documentation project and so the content must be accurate, informative and concise.
120124

121125
Generative AI can produce content that is general and verbose;
122126
avoid using it for any issues, pull requests, comments and discussions.
127+
123128
If it is genuinely helpful to use generative AI then it **must** be declared in any pull request or issue,
124129
failure to do so can result in the contribution being closed or even deleted.
125130

126131
There is no need to use agentic AI to create issues or pull requests;
127132
templates for all issues and pull requests **must** be used.
128133
Failure to use the templates can result in the issue / pull request being closed or even deleted.
129134

135+
Be mindful that the leaders and maintainers of the Developer Guide are volunteers with their own day jobs;
136+
we do this on our own time for the benefit of the open source community and OWASP in particular.
137+
AI slop drains maintainers' time and is actively harmful to this project.
138+
130139
### Running web document locally
131140

132141
Test the web document locally before creating / updating a pull request.

0 commit comments

Comments
 (0)