язык: сняты «провенанс» и «интейк», назван образец стиля

Оба слова стояли в закрытом словаре правила 6 с оговоркой, и обе оговорки
отвергали один русский вариант, а вывод из них делался про все. Отсюда общее
требование к записи словаря: она обязана говорить, чем слово незаменимо, а не
чем плох один из кандидатов. Латинизм, переживший проверку одним синонимом, —
не имя вещи, а непроверенная привычка.

Провенанс заменён двумя словами, потому что смысла было два, и это же его и
держало: происхождение у числа (чем и при каких условиях получено) и откуда у
вопроса и находки (кто нашёл, каким проходом, из какой записи журнала). Слово
стояло и в скелете docs/review.md, уезжающем в репозитории проектов, поэтому
раскладка повышена до версии 4 с записью журнала: правка формы вопроса и
проход grep по docs/.

Интейк заменён заведением с названным источником — «из диалога», «из ревью».
Оговорка защищала слово от голого «заведения» и в этом была права, но в паре с
источником двусмысленности нет, а скилл задач уже называет операцию так же.
Раскладку это не двигает: слово жило только в прозе плагина.

Образец стиля назван прямо и отдельным разделом: научно-популярная книга, не
спецификация и не конспект для себя. Три умолчания — воды нет, сложных
конструкций нет, англицизм исключение с причиной. Находок образец не
порождает: он для того, кто пишет, а вычитка судит по правилам, иначе «звучит
сложно» стало бы находкой и порог правки перестал бы работать.

Журнал решений: темы 70 и 71, Р258–Р264 и С244–С249. Остальной словарь —
триаж, дедуп, чек-лист, дифф, промпт, чекпоинт, синк — не пересматривался, и
это сказано записью: пересмотр меняет язык всего корпуса и делается своей
работой, а не попутно.
This commit is contained in:
av
2026-08-13 19:43:08 +03:00
parent e78a4311a7
commit e5dc0a1a39
26 changed files with 279 additions and 62 deletions
+50 -6
View File
@@ -47,6 +47,35 @@
эстетическая: текст, из которого нельзя достать факт, заставляет открывать код,
а это и есть цена, которой мы избегаем.
## Образец: научно-популярная книга
**Так, как пишут хорошую научно-популярную книгу.** Не спецификация, не статья в
блоге, не конспект для себя: текст, который объясняет устройство **точными
простыми словами** и понятен с первого прохода тому, кто эту систему не писал.
Из образца следуют три умолчания, и все три — про плотность, а не про красоту:
- **воды нет.** Каждая фраза несёт сведение: что устроено так, почему так и что
из этого следует. Абзац, из которого ничего нельзя достать, вычёркивается
целиком, а не переписывается;
- **сложных конструкций нет.** Причастный оборот внутри придаточного, три
отрицания подряд, предложение на пять строк — читатель разбирает такую фразу
дважды, и второй раз он её уже не разбирает. Причинную связь при этом не
режут: «поэтому», «иначе», «раз так» — сведения;
- **англицизм — исключение, требующее причины.** Умолчание обратное принятому в
разработке: пишем по-русски, а иностранное слово остаётся, только когда оно
**имя вещи** или когда русский аналог искажает смысл. Какая причина годится,
разбирает правило 5; закрытый список принятых слов — правило 6.
Термин здесь не запрещён — запрещена **перегрузка**: термин, который вводится
одной строкой, дешевле описания в три предложения, а термин, который
предполагается известным, дороже обоих (правило 8).
**Образец находок не порождает.** Он для того, кто пишет; вычитка судит по
правилам, и правка без нарушенного правила не делается (раздел «Порог правки»).
Иначе «мне кажется, звучит сложно» стало бы находкой, и список замечаний
перестали бы читать целиком.
## Что взято сверх правил вычитки
Эти три требования судит человек, а не проход вычитки: находка по ним требует
@@ -158,9 +187,7 @@
| Термин | Что называет |
| --- | --- |
| интейк | заведение записи с фильтром и дедупом: «заведение» называет создание файла, слить их — смешать две операции |
| триаж | стадия конвейера, сводящая находки в решение |
| провенанс | обязательное свойство числа: чем и при каких условиях получено. «Источник» рядом называет саму запись, а не свойство |
| дедуп, дедупликация | сверка нового против уже лежащего |
| чек-лист | перечень, по которому идут сверху вниз, называя исход каждой строки |
| дифф, `--base` | разница между состояниями в git |
@@ -177,9 +204,26 @@
Отсюда же читается снятое. Эти слова из текстов убраны, и возвращать их не
надо: **конфляция** (смешение), **декорреляция** (разведённость, разведён с
кем-то), **непоймание** (почему не поймали), **эвал-сет** (проверочный
набор), **гайд** (руководство), **опиниативный** (проход с мнением). Каждое
было латинизмом или калькой при живом русском слове, и каждое к моменту снятия
жило в трёх-шести файлах разом — то есть выглядело словарём, не будучи им.
набор), **гайд** (руководство), **опиниативный** (проход с мнением),
**провенанс** (происхождение числа: чем и при каких условиях получено),
**интейк** (заведение записей — из диалога, из ревью: операция зовётся своим
источником). Каждое было латинизмом или калькой при живом русском слове, и
каждое к моменту снятия жило в трёх-шести файлах разом — то есть выглядело
словарём, не будучи им.
**Провенанс и интейк сняты из самого словаря, и это прецедент.** Оба стояли в
нём с оговоркой, и обе оговорки были верны, но доказывали меньше, чем от них
брали.
| Слово | Чем защищалось | Чем заменено |
| --- | --- | --- |
| провенанс | «источник» рядом называет саму запись, а не свойство | **происхождение** у числа, **откуда** у вопроса и находки: смысла было два, и это же и держало латинизм |
| интейк | «заведение» называет создание файла, а не отбор с дедупом | **заведение с названным источником** — «из диалога», «из ревью»: так операция и называется в самом скилле задач |
Общее у обоих: оговорка отвергала **один** русский вариант, а вывод делался
про все. **Латинизм, переживший проверку одним синонимом, — не имя вещи, а
непроверенная привычка**, и запись в словаре обязана говорить, чем слово
незаменимо, а не чем плох один из кандидатов.
7. **Жаргон и метафоры заменяются прямым называнием.** Автору образ понятен,
читателю — нет.
@@ -228,7 +272,7 @@
Величина нужна читателю редко, а когда нужна — её называет сам корпус в
момент чтения: каталог, индекс, команда. Абзац её только запоминает.
**Замер с провенансом — не счёт корпуса.** «Прозаический триггер дал 6
**Замер с названным происхождением — не счёт корпуса.** «Прозаический триггер дал 6
записей ADR на 43 изменения» описывает прошлое, а прошлое не пополняется: это
факт по правилу 2, и трогать его нельзя. Разница проверяется вопросом
«изменится ли число само, без правки текста».