docs: improve guidance for AI-assisted bug reports
Get series with b4
b4 am [email protected]Versions newest first
- v1 Latest5 patches 3 repliesIn review
Patches in v1 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/5 | docs: threat-model: clarify "security bug" vs "vulnerability"Documentation/ | +11 | 0 replies | |
| 2/5 | docs: threat-model: move fake devices out of "non production use"Documentation/ | +14 | 0 replies | |
| 3/5 | docs: security-bugs: clarify what counts as a valid versionDocumentation/ | +4 | 0 replies | |
| 4/5 | docs: coding-assistant: explain important steps when looking for bugsDocumentation/ | +37 | 0 replies | |
| 5/5 | docs: security-bugs: clarify some mandatory steps for AI reportsDocumentation/ | +22 | 0 replies |
Reviews trailers per patch
No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.
Cover letter [PATCH 0/5] docs: improve guidance for AI-assisted bug reports
While vulnerability reporters have now started CCing maintainers, showing they read the docs, the security team still spends a lot of time repeating the same comments about tested version, incomplete fixes, poor email client setup causing formatting issues making patches unusable, unverified reports and missing Assisted-By tags, each time for AI-assisted reports.
This series adds small updates to security-bugs.rst, threat-model.rst and coding-assistant.rst to better deal with this and provide minimal instructions helping the LLM follow our expectations.
The updates were iteratively and carefully tested with 3 models, Opus-5, Qwen3.6-27B-Architect-Polaris2-Fable-B-F451, and Gemini, until all of them strictly followed the rules.
It is expected to further improve the situation.
Willy Tarreau (5):
docs: threat-model: clarify "security bug" vs "vulnerability"
docs: threat-model: move fake devices out of "non production use"
docs: security-bugs: clarify what counts as a valid version
docs: coding-assistant: explain important steps when looking for bugs
docs: security-bugs: clarify some mandatory steps for AI reports
Documentation/process/coding-assistants.rst | 37 +++++++++++++++++++ Documentation/process/security-bugs.rst | 26 ++++++++++++++ Documentation/process/threat-model.rst | 39 ++++++++++++--------- 3 files changed, 85 insertions(+), 17 deletions(-)
Signature · 1 line
2.52.0