docs: point the README at SECURITY.md and disambiguate the two security docs
test / test (push) Has been cancelled

A reader looking for where to report a flaw had no path from the README: the
only security row led to docs/security.md, which is the design rationale, not
a reporting channel. That row is now "Security design", and a line under the
table sends vulnerability reports to SECURITY.md instead of the issue tracker.

development.md gains SECURITY.md in its user-facing deliverables table and
drops "internal" from the roadmap row, which stopped being true when the
roadmap was reframed for outside readers.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-09 22:58:56 +03:00
parent 295d1afb7d
commit 691d3c255f
3 changed files with 11 additions and 2 deletions
+5
View File
@@ -21,6 +21,11 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); version
unchanged: same requirements, same accepted risks, same ADR. The reviewing
model is no longer named in the text; the fact that a pre-release review ran,
and its date, stay.
- The README documentation table now points at `SECURITY.md` for reporting a
vulnerability, and the `docs/security.md` row is renamed *Security design*
with two files a reader could reasonably call "security", the table said
which is which only by accident. `development.md` lists `SECURITY.md` among
the user-facing deliverables and no longer calls the roadmap internal.
- [docs/roadmap.md](docs/roadmap.md) is now in English, with a short note on
how to read it from outside the project: nothing in it is a commitment, there
are no dates, and the stated order is a recommendation. The model assigned to