docs: точного числа накопленного в документах больше нет
- CLAUDE.md, «Язык»: ссылаться можно на конкретную запись или на весь корпус разом, но не на их количество — число протухает молча, машина его не считает. Изъятие названо: неизменное число и историческое в записи о прошлом остаются. - Сняты счёты capability, прогонов ревью, типизированных ошибок, воркеров, сверок документов и правил линтера в docs/, спеке pipeline и CLAUDE.md. - Заодно исправлено то, что этот же счёт и скрывал: типизированных ошибок три, а не две — LostAcquisitionError был потерян из перечня.
This commit is contained in:
@@ -141,7 +141,7 @@ task gate # весь набор проверок разом
|
||||
**затронутых файлах** дешёвую часть: `gofmt` (правит на месте и добавляет в
|
||||
коммит), `golangci-lint` по пакетам тронутых файлов, `shellcheck`, `hadolint`,
|
||||
`gitleaks` по индексу. Только гейту остаются сборка, `go vet`, тесты целиком,
|
||||
сверка версий Go, три сверки документов и `govulncheck`: они смотрят всё
|
||||
сверка версий Go, сверки документов и `govulncheck`: они смотрят всё
|
||||
дерево либо требуют сети, а pre-commit обязан быть быстрым.
|
||||
- **Шагу `vulns` нужна сеть**, и он один такой: база уязвимостей живёт на
|
||||
vuln.go.dev. Без сети шаг краснеет, а не пропускается молча; сам инструмент
|
||||
@@ -155,8 +155,8 @@ task gate # весь набор проверок разом
|
||||
которого образ перестаёт собираться, но собираемости не проверяет. Собрать
|
||||
образ по-прежнему может только человек — `task image`, и на подъёме версии
|
||||
это обязательно;
|
||||
- собираемость `Dockerfile`: `hadolint` судит форму, а не сборку, и два его
|
||||
правила подавлены поимённо — `DL3007` до задачи `pin-runtime-image-base` и
|
||||
- собираемость `Dockerfile`: `hadolint` судит форму, а не сборку, и часть его
|
||||
правил подавлена поимённо — `DL3007` до задачи `pin-runtime-image-base` и
|
||||
`DL3018` по существу (alpine не держит старые версии пакетов, закрепление
|
||||
ломает сборку через недели). Причины стоят строками в `Taskfile.yml`;
|
||||
- `gitleaks` — висит на pre-commit в `lefthook.yml` и смотрит только индекс
|
||||
@@ -231,3 +231,18 @@ task gate # весь набор проверок разом
|
||||
- Документация, комментарии, сообщения коммитов — русский.
|
||||
- Код и идентификаторы — английский.
|
||||
- Текст, который видит пользователь Telegram, — русский.
|
||||
- **Точного числа накопленного в документах нет.** «Три capability», «пять
|
||||
прогонов ревью», «две типизированные ошибки» расходятся с действительностью на
|
||||
первой же задаче, которая прибавит четвёртую, — и расходятся молча: машина
|
||||
такое не считает, а читатель верит написанному. Ссылаться можно только на
|
||||
**конкретную запись** (по имени, со ссылкой) либо на **весь корпус разом**
|
||||
(«заведённые capability», «записи журнала ниже»). Само перечисление при этом
|
||||
законно: перечень обновляют вместе с предметом, а число живёт отдельно от него
|
||||
и потому протухает в одиночку.
|
||||
|
||||
*Изъятие:* число, которое не растёт с работой, остаётся числом — количество
|
||||
уровней журнала в библиотеке, ступеней сборки образа, состояний списка на
|
||||
экране. Так же законно **историческое** число в записи о прошлом: «решением от
|
||||
2026-08-13 закрыты четыре задачи» описывает событие, а не сегодняшний счёт.
|
||||
Настройки с числовым значением — свой случай, их дом
|
||||
[docs/database.md](docs/database.md).
|
||||
|
||||
Reference in New Issue
Block a user