39 lines
5.0 KiB
Markdown
39 lines
5.0 KiB
Markdown
# Полная вычитка архива — 31 июля 2026 года
|
|
|
|
## Объём
|
|
|
|
Проверен весь опубликованный архив: **371 статья**. В него входят 358 редакционных ревизий 2018–2027 годов и 13 старых материалов 2017–2019 годов, для которых раньше не было отдельного слоя ревизий. Исходные записи в `web/data/articles.json` не перезаписываются: приложение получает стабильный slug и дату из архива, а читательский HTML — из `web/data/editorial-revisions.mjs`.
|
|
|
|
Новая редактура следует практическим принципам [«Пиши, сокращай»](https://bureau.ru/books/pishi/95): главное вынесено вперёд, абзац держит одну мысль, абстракция сопровождается действующим субъектом и примером, а сокращение не убирает механизм, ограничение и проверку.
|
|
|
|
## Проход 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-сборка приложения.
|
|
|
|
## Команды повторной проверки
|
|
|
|
```text
|
|
node web/scripts/audit-style-corpus.mjs
|
|
cd web && npm run audit:articles -- --all-articles
|
|
cd web && npm run build
|
|
```
|
|
|
|
Публикация остаётся обратимой: при следующем редакторском проходе меняется соответствующий revision-скрипт или очиститель читательского HTML, а базовый архив и чужие незакоммиченные файлы не затрагиваются.
|