linux/Documentation/process
Willy Tarreau bea79063a3 docs: threat-model: clarify "security bug" vs "vulnerability"
Throwing an LLM (Opus 5) at a file looking for random bugs after having
read the threat model made it ignore certain bugs it found because "the
threat model said they must be ignored". When asked why, the LLM
rightfully reported the ambiguous wording used at a few places:
"is not a security bug", which can also be read as "is not a bug",
despite the rest of the document. That is particularly true when the
LLM decides to look for info using grep.

This change replaces "security bug" with "vulnerability" at a few places
in order to remove this identified ambiguity, and uses "bugs" instead of
issues in two such sentences to insist that what is described remains a
bug.

Cc: Greg KH <greg@kroah.com>
Signed-off-by: Willy Tarreau <w@1wt.eu>
Link: https://patch.msgid.link/20260802203540.3453-2-w@1wt.eu
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2026-08-04 16:24:50 +02:00
..
debugging docs: kgdb: Fix path of driver options 2026-06-23 14:35:50 -06:00
1.Intro.rst Doc: correct spelling and wording mistakes 2026-01-06 14:39:58 -07:00
2.Process.rst linux-next: update maintainer info. 2026-02-23 14:36:11 -07:00
3.Early-stage.rst Documentation/process: use scripts/get_maintainer.pl on patches 2022-05-09 16:12:16 -06:00
4.Coding.rst Doc: correct spelling and wording mistakes 2026-01-06 14:39:58 -07:00
5.Posting.rst doc: development-process: add notice on testing 2026-02-02 10:02:05 -07:00
6.Followthrough.rst docs: remove the tips on how to submit patches from MAINTAINERS 2023-07-03 08:35:23 -06:00
7.AdvancedTopics.rst Doc: correct spelling and wording mistakes 2026-01-06 14:39:58 -07:00
8.Conclusion.rst docs: process: remove outdated submitting-drivers.rst 2022-07-14 15:03:57 -06:00
adding-syscalls.rst docs: fix 're-use' -> 'reuse' in documentation 2026-02-02 09:54:15 -07:00
applying-patches.rst
backporting.rst Documentation: process: backporting: fix missing subject 2026-03-03 10:24:17 -07:00
botching-up-ioctls.rst Documentation: Fix typos 2023-08-18 11:29:03 -06:00
changes.rst Things have calmed down a bit on the docs front, with no earthshaking 2026-06-16 08:35:59 +05:30
code-of-conduct-interpretation.rst Documentation/CoC: Spell out the TAB role in enforcement decisions 2025-03-12 16:31:48 -06:00
code-of-conduct.rst
coding-assistants.rst docs: add AI Coding Assistants documentation 2026-01-06 14:55:06 -07:00
coding-style.rst Documentation: Fix syntax of kmalloc_objs example in coding style doc 2026-06-01 12:48:20 -06:00
conclave.rst Documentation: Project continuity 2026-01-24 16:16:47 -08:00
contribution-maturity-model.rst Documentation/process: Add Linux Kernel Contribution Maturity Model 2023-03-14 12:22:59 -06:00
cve.rst Documentation: Document the Linux Kernel CVE process 2024-02-17 14:46:39 +01:00
deprecated.rst string: Remove strncpy() from the kernel 2026-06-18 16:39:31 -07:00
development-process.rst docs: use toctree :caption: and move introduction 2023-11-17 13:05:26 -07:00
email-clients.rst docs: process: email-client: add Thunderbird "Toggle Line Wrap" extension 2026-01-06 14:38:28 -07:00
embargoed-hardware-issues.rst MAINTAINERS: update ndesaulniers 2026-07-06 15:49:29 -07:00
generated-content.rst Documentation: Provide guidelines for tool-generated content 2026-01-20 14:51:22 -07:00
handling-regressions.rst docs: handling-regressions: add, trim, and sort quotes from Linus 2026-03-03 11:11:01 -07:00
howto.rst Documentation: fix links to mailing list services 2024-07-03 16:52:54 -06:00
index.rst Documentation: security-bugs: explain what is and is not a security bug 2026-05-12 11:09:14 -06:00
kernel-docs.rst kernel-docs: Add book to process/kernel-docs.rst 2025-02-18 13:24:01 -07:00
kernel-driver-statement.rst
kernel-enforcement-statement.rst
license-rules.rst LICENSES: Explicitly allow SPDX-FileCopyrightText 2026-03-20 11:42:50 +01:00
maintainer-handbooks.rst docs: maintainers_include: Only show main entry for profiles 2026-05-03 09:24:30 -06:00
maintainer-kvm-x86.rst Documentation/process: Add a maintainer handbook for KVM x86 2023-06-22 14:25:38 -07:00
maintainer-netdev.rst docs: maintainer-netdev: fix typo in "targeting" 2026-04-22 20:16:58 -07:00
maintainer-pgp-guide.rst docs: maintainer-pgp-guide.rst: add a reference for kernel.org sign 2026-02-27 06:34:06 +01:00
maintainer-soc-clean-dts.rst docs: process: maintainer-soc-clean-dts: linux-next is decisive 2025-02-26 13:15:57 -06:00
maintainer-soc.rst Documentation: process: fix brackets 2026-06-12 13:19:44 -06:00
maintainer-tip.rst Documentation/maintainer-tip: Fix grammar 2026-03-03 09:59:23 -07:00
maintainers.rst docs: maintainers: add SPDX license to the file 2026-05-03 09:24:30 -06:00
management-style.rst
programming-language.rst A handful of small, late-arriving documentation fixes. 2026-02-15 10:47:59 -08:00
researcher-guidelines.rst Documentation: update mailing list addresses 2024-02-21 13:44:21 -07:00
security-bugs.rst docs: security-bugs: add a link to the threat-model documentation 2026-05-14 06:23:06 -06:00
stable-api-nonsense.rst
stable-kernel-rules.rst docs: stable-kernel-rules: fix typo sent->send 2024-05-02 10:20:27 -06:00
submit-checklist.rst docs/.../submit-checklist: Use Documentation/admin-guide/abi.rst for cross-ref of README 2025-03-12 16:41:56 -06:00
submitting-patches.rst docs: submitting-patches: Clarify that "reviewer" is a person 2026-05-25 14:04:30 -06:00
threat-model.rst docs: threat-model: clarify "security bug" vs "vulnerability" 2026-08-04 16:24:50 +02:00
volatile-considered-harmful.rst