Files
progcode/editorial/reviews/full-corpus-2026-07.md
huncode 7c5b19c960
Build and deploy / deploy (push) Successful in 18s
edit full article archive to publication standard
2026-07-31 23:08:19 +03:00

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, а базовый архив и чужие незакоммиченные файлы не затрагиваются.