5.0 KiB
Полная вычитка архива — 31 июля 2026 года
Объём
Проверен весь опубликованный архив: 371 статья. В него входят 358 редакционных ревизий 2018–2027 годов и 13 старых материалов 2017–2019 годов, для которых раньше не было отдельного слоя ревизий. Исходные записи в web/data/articles.json не перезаписываются: приложение получает стабильный slug и дату из архива, а читательский HTML — из web/data/editorial-revisions.mjs.
Новая редактура следует практическим принципам «Пиши, сокращай»: главное вынесено вперёд, абзац держит одну мысль, абстракция сопровождается действующим субъектом и примером, а сокращение не убирает механизм, ограничение и проверку.
Проход 1 — смысл и структура
- Удалена из читательского слоя мета-лексика о планах выпуска, дате отсечения источников, развитии автора, внутренних hand-off и технических статусах фикстур.
- Для 13 старых материалов добавлены самостоятельные введения с симптомом и ценой ошибки, рисунок с
altи подписью, механизм, кодовый пример, таблица диагностики, последовательность действий, ограничения и проверяемые источники. - Подключены три ранее созданные, но не входившие в публикационный слой партии: январь, февраль и апрель 2018 года.
- Сохранены исходные даты и slug. Заголовки старых материалов уточнены там, где они обещали меньше, чем должен был раскрыть текст.
Проход 2 — факты и техника
- Для каждого материала оставлены официальные или первичные источники и конкретизирована граница применимости версии.
- Для новых ревизий старого архива проверены 39 уникальных ссылок: все доступные ответы на 31.07.2026 вернули HTTP 200; устаревшие ссылки, унаследованные из тела старых статей, убраны из HTML и заменены действующими официальными источниками.
- Проверены наличие примера кода, таблицы, изображения, подписи,
alt, порядка действий и отдельного раздела источников. - Примеры не выдают синтетические данные за замер production и не содержат инструкций по запуску подозрительных файлов.
Проход 3 — слова, предложения и выпуск
- На публикационной границе включён
cleanReaderHtml: он переводит внутренние статусы фикстур в понятные читателю технические формулировки и убирает шаблонные вводные обороты. - Разделены две перегруженные фразы в материалах 2021 и 2025 годов; финальный стилевой аудит не нашёл обычных предложений длиннее 45 слов. Код, таблицы и списки в эту метрику не входят.
- Проверен основной объём каждой статьи: от 5 000 до 15 000 знаков без заголовка, метаданных и списка источников.
- Выполнены
git diff --check, структурный аудит 371 статьи, стилевой аудит 371 статьи и production-сборка приложения.
Команды повторной проверки
node web/scripts/audit-style-corpus.mjs
cd web && npm run audit:articles -- --all-articles
cd web && npm run build
Публикация остаётся обратимой: при следующем редакторском проходе меняется соответствующий revision-скрипт или очиститель читательского HTML, а базовый архив и чужие незакоммиченные файлы не затрагиваются.