docs(dm): изложение выбора витрин переписано
- Зачем: - объяснение формы витрин читалось искусственно и использовало неуместное слово «менти». - Что: - выбор таблицы или представления объяснён через конкретные действия в задании. - слово «менти» убрано из dm.md и AGENTS.md. - описание факультатива и ссылка на раздел DM приведены к новому тексту. - Проверка: - git diff --check. - проверено отсутствие слова «менти» в изменённых документах и наличие целей ссылок.
This commit is contained in:
1 parent
f0c7fe0c74
commit
af3f23f9ea
3 files changed
+47
-43
No files matched your search
@@ -8,15 +8,15 @@
|
||||
Стенд строится по спеке
|
||||
[«Боевой реализм стенда (v2)»](docs/specs/2026-07-30-stand-v2-realism.md).
|
||||
|
||||
Отсюда вопрос к любой доработке — коду, проверке, документу: **чему на ней
|
||||
научится менти?** Ответ называется одной фразой до того, как писать. Не
|
||||
Отсюда вопрос к любой доработке — коду, проверке, документу: **чему она
|
||||
учит?** Ответ называется одной фразой до того, как писать. Не
|
||||
складывается фраза — это вопрос владельцу, а не строчка кода: проверки в этом
|
||||
репозитории однажды уже переросли продукт.
|
||||
|
||||
**Усложнение не бесплатно, и платит за него учебная ценность.** Чем сложнее
|
||||
стенд, тем хуже он как учебный материал: внимание менти конечно, и каждая
|
||||
стенд, тем хуже он как учебный материал: внимание читателя конечно, и каждая
|
||||
конструкция, которую он обязан расшифровать по дороге к уроку, списывается с
|
||||
этого счёта. Поэтому вопрос выше имеет вторую половину: **что менти платит,
|
||||
этого счёта. Поэтому вопрос выше имеет вторую половину: **что читатель платит,
|
||||
чтобы это прочесть, и что получает взамен?** Ответ «вопрос — и ничего»
|
||||
означает, что писать не нужно.
|
||||
|
||||
@@ -168,7 +168,7 @@ Airflow) и названия из кода. Если для понятия ес
|
||||
отдельного индекса в `optional/` нет.
|
||||
- Имена файлов в `docs/handbook/` — слаг строчными латинскими буквами через
|
||||
дефис, индекс папки — `README.md`. Здесь живет путеводитель по стенду:
|
||||
учебные главы для менти. Ни дат, ни номеров: глава — живой документ и
|
||||
учебные главы для читателя. Ни дат, ни номеров: глава — живой документ и
|
||||
правится вместе с тем, что описывает. Исходники интерактивной карты лежат
|
||||
подпапкой `architecture-map/`, а ее рендер — файлом `architecture-map.html`
|
||||
рядом с главами.
|
||||
|
||||
Reference in new issue
Block a user