mirror of
https://github.com/Ku6epXBOCTuK/easy-png-tools.git
synced 2026-11-13 17:08:20 +00:00
docs: review all
This commit is contained in:
+18
-5
@@ -47,11 +47,11 @@
|
||||
которых 14 — ложные («30 дней» политики архива, «9 опций» описания поля, «4
|
||||
проекта» факт из `playwright.config.ts», цитата самого правила).
|
||||
|
||||
- Правило всё равно неполно: ловит «122 инструмента», но не «инструментов —
|
||||
122», не «более 100», не «≈120»; на каждое обходное движение нужна правка
|
||||
правила, а allowlist легитимных чисел становится вторым источником долга.
|
||||
Худший исход — не «шумно», а «вроде гейт, а толку нет»: срабатывания на пустом
|
||||
месте забейзелят, и через месяц правило перестанет ловить настоящие нарушения.
|
||||
- Правило всё равно неполно: ловит «M инструментов», но не «инструментов — M»,
|
||||
не «более 100», не «≈120»; на каждое обходное движение нужна правка правила, а
|
||||
allowlist легитимных чисел становится вторым источником долга. Худший исход —
|
||||
не «шумно», а «вроде гейт, а толку нет»: срабатывания на пустом месте
|
||||
забейзелят, и через месяц правило перестанет ловить настоящие нарушения.
|
||||
Видимое блокирующее правило, которое на деле ничего не проверяет, хуже
|
||||
отсутствия правила.
|
||||
- Соблюдение правила дешевле обхода: «список — в `docs/tools-map.md`» стоит
|
||||
@@ -82,6 +82,19 @@
|
||||
про парсер, а не молча перестанет что-либо проверять. Входит в обычный
|
||||
`pnpm --dir web test`; новых гейтов и конфигов не добавляет.
|
||||
|
||||
Граница автоматизации: парсер читает разделы «Реализовано», «Можно добавить» и
|
||||
«Идеи», но проверяет их в разных направлениях. Раздел 1 сверяется с реестром
|
||||
обеими сторонами (slug без страницы и страница без записи). Разделы 2 и 3
|
||||
сверяются только в одну сторону: там slug'и намеренно несуществующие, поэтому
|
||||
проверяется, что **ни один из них не является реальной страницей** —
|
||||
реализованный инструмент, оставшийся в плане, роняет тест. Проверять «у плана
|
||||
есть запись в реестре» нельзя по построению: список плановый, а не фактический.
|
||||
|
||||
Плановые разделы устроены прозой, поэтому их разбор другой: берутся все токены
|
||||
нужной формы из всего буллита, а не только из «головы» до тире. Следствие для
|
||||
авторов карты: реализованные страницы в планах называются прозой между
|
||||
буллитами, а не внутри них.
|
||||
|
||||
## 5. Visual snapshots — не вводим
|
||||
|
||||
`toHaveScreenshot` сравнивает страницу с PNG-baseline из прошлого коммита, а не
|
||||
|
||||
Reference in New Issue
Block a user