progcode/editorial/production/README.md

Производство редакционных партий

На 31 июля 2026 года строгий аудит проходит 271 из 358 созданных материалов. Остальные 87 не считаются «почти готовыми»: их нужно заменить, а не косметически удлинить.

Одна партия

Партия содержит три связанные, но не повторяющие друг друга статьи:

1. практический разбор с воспроизводимым решением;
2. объяснение механизма и границ ответственности;
3. полевой кейс, диагностику или сравнение вариантов.

Для каждой статьи автор готовит исследование, основной текст на 5 000–15 000 знаков, отдельный visual asset, таблицу, пример и список источников. Черновой скрипт не имеет права писать в web/data/articles.json: он только печатает ревизии через --print-revisions.

Вход в публикацию

Основной редактор интегрирует партию только после того, как одновременно выполнены:

• исследовательское ревью: ссылки проверены, версии и ограничения названы;
• редакторское ревью: проблема в начале, нет шаблонного языка, голос соответствует году;
• визуальное ревью: рисунки открываются, таблицы работают на 375px, у рисунков есть alt и подписи;
• node --check, npm run audit:draft -- scripts/upgrade-YYYY-MM.mjs, XML-проверка диаграмм, npm run audit:articles -- <slugs> и production-сборка проходят.

После этого рядом с партией появляется запись в editorial/reviews/, а изменение публикуется отдельным коммитом. Ни один скрипт не должен перегенерировать уже отревьюированный архив целиком.