ещё обновление доки

2026-07-10 18:29:56 +04:00
parent 0eef72a2c2
commit fbe22f6a94
9 changed files with 290 additions and 8 deletions
@@ -97,6 +97,14 @@ Nightly/weekly:
 - Tooling candidates tracked in `docs/TOOLING_CATALOG.md` with status and pinned version.
 - Feature coverage links implementation, tests, fidelity evidence and known gaps.
 - Generated API docs for documented GDScript/GDExtension public surface включаются в quality gate, когда pipeline подготовлен.
+
+## QAR-9A. Code clarity and KISS
+
+- Naming и simplicity проверяются по `docs/CODING_STANDARD.md`.
+- Длинное точное имя предпочтительнее неочевидного сокращения; length не является целью сама по себе.
+- Complexity metrics используются как сигнал для review, а не автоматическая причина переписывания domain-heavy code.
+- Premature generic frameworks, service locators, duplicate registries и unmeasured native optimizations блокируют integration.
+- Неизбежно сложный parser/protocol/streaming/UI security code обязан быть изолирован, иметь reference fixtures и диаграмму.
 - Contributor workflow describes smallest reproducible diagnostic commands.

 ## QAR-10. Packaging and release