Skip to content

docs: improve guidance for AI-assisted bug reports

Willy Tarreau linux-doc lkml workflows 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest5 patches 3 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/5docs: threat-model: clarify "security bug" vs "vulnerability"Documentation/process/threat-model.rst+11 -110 replies
2/5docs: threat-model: move fake devices out of "non production use"Documentation/process/threat-model.rst+14 -90 replies
3/5docs: security-bugs: clarify what counts as a valid versionDocumentation/process/security-bugs.rst+4 -00 replies
4/5docs: coding-assistant: explain important steps when looking for bugsDocumentation/process/coding-assistants.rst+37 -00 replies
5/5docs: security-bugs: clarify some mandatory steps for AI reportsDocumentation/process/security-bugs.rst+22 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

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