docs: линтеры и механизация переехали записью конвенций go-linters.md
- документ docs/autotests.md снят: перечень правил, подавлений и лестница механизации — это конвенция о том, чем машина читает код, и место ей среди прочих записей - в шапке названо, чего в записи нет: как писать тесты. Свойства, которые обязан проверять тест, остаются в review.md, «Типовые узлы» - ссылки переставлены в памятке, индексе конвенций, четырёх записях, review.md, .golangci.yml, lefthook.yml и пакете сканеров
This commit is contained in:
@@ -6,8 +6,8 @@
|
||||
|
||||
**Прозой остаётся только то, что не выражается правилом.** Свойство, ставшее
|
||||
правилом линтера или тестом-сканером, отсюда **удаляется** и переезжает в
|
||||
перечень «Механизировано» документа [../autotests.md](../autotests.md) — дома
|
||||
инструментов, которые читают код. Причина: файл на несколько сотен строк
|
||||
перечень «Механизировано» записи [go-linters.md](go-linters.md) — дома правил,
|
||||
которыми машина читает код. Причина: файл на несколько сотен строк
|
||||
размазывает внимание по тривиальному — и модель, и человек добросовестно
|
||||
проверят именование и не дойдут до формы решения.
|
||||
|
||||
@@ -48,14 +48,15 @@ htmx, а здесь решено делать SPA — и перенесённы
|
||||
- [web-ui.md](web-ui.md) — веб-UI: Vue 3 с Vite и статикой в бинарнике,
|
||||
однофайловые компоненты, таблица маршрутов, состояние в экране, одна обёртка
|
||||
над `fetch`, показ ошибок и состояний списка.
|
||||
- [go-linters.md](go-linters.md) — линтеры и механизированные проверки: лестница
|
||||
механизации, два круга (pre-commit и гейт), перечень правил и подавлений,
|
||||
порядок заведения нового правила. Про инструменты, а не про то, как писать
|
||||
тесты.
|
||||
|
||||
## Что из этого проверяет машина
|
||||
|
||||
Перечень правил, доведённых до проверки, и место настройки каждого — в
|
||||
[../autotests.md](../autotests.md). Там же сказано, что из перечисленного в
|
||||
Перечень правил, доведённых до проверки, и место настройки каждого — в записи
|
||||
[go-linters.md](go-linters.md). Там же сказано, что из перечисленного в прочих
|
||||
записях осталось прозой и потому проверяется человеком на каждом ревью заново, и
|
||||
там же названы остатки правил — то, что правило не ловит. Числа механизированного
|
||||
здесь нет намеренно: оно протухает при каждом новом правиле.
|
||||
|
||||
Здесь этот перечень не повторяется. Дом у него один, и он не тут: конвенции
|
||||
говорят, как писать код, а не какими инструментами его читают.
|
||||
|
||||
Reference in New Issue
Block a user