Skip to content

v9.0 — сквозное ревью, правки по нему и чистка от воды

Choose a tag to compare

@fuodorov fuodorov released this 13 Sep 13:40
· 5 commits to main since this release

Сквозное ревью книги, правки по нему и чистка текста от воды. Тридцать коммитов, 76 файлов.

Ревью

Книгу прошли семнадцать рецензентов: одиннадцать по разделам и шесть по сквозным линзам — терминология, структура, ссылки и печатная сборка, запускаемость листингов, дидактика, физика и математика. Каждую находку затем проверял отдельный агент, обязанный открыть файл, сверить цитату дословно и воспроизвести дефект; 18 находок на этом отсеяны. После схлопывания дубликатов осталось 138 пунктов, 12 из них критичные.

Самое серьёзное из найденного:

  • раздел «Одна задача в четырёх хранилищах» написан на Flask, но фреймворк в книге не назывался ни разу — не запускался ни один из тринадцати листингов;
  • обе функции SciPy, на которых держится численная часть главы про KENV, удалены из библиотеки (cumtrapz с 1.14, scipy.misc.derivative с 1.12);
  • блок про SettingWithCopyWarning описывал механизм, которого в pandas 3.x нет;
  • «потоки не помогут никогда» подано как закон языка при существующей с 3.13 свободнопоточной сборке;
  • ускоренная is_prime объявляла простыми ноль и все отрицательные числа;
  • пять листингов падали с NameError из-за неимпортированных имён;
  • вводная глава учила неверной модели timeit, противореча двум главам ниже.

Правки по ревью

Применены 172 правки, 43 — с отступлением от предложенной формулировки там, где она не вставала в грамматику соседней фразы. Двенадцать коммитов по частям книги, каждый с обоснованием в сообщении.

Осталось автору — то, что требует его рук: перемерить joblib в главе про GIL (нынешнее число опровергает вывод главы), вклеить профили line_profiler в главу про скорость, перегенерировать блокнот экспресс-курса на Python 3.12+, нарисовать четыре картинки взамен горячих ссылок на imgur (в печать они не попадают), решить судьбу dR_rmsdz = 35.4e-3 в главе про KENV, удалить 38 осиротевших картинок, разобраться с позициями [20]–[22] списка литературы, ни на что не опирающимися.

Замечание о том, что части «Обрабатываем данные» и «Ускоряем код» не обеспечены заданиями практикума, остаётся открытым.

Чистка от воды

Текст читался как написанный языковой моделью — не из-за словаря, а из-за риторических рамок вокруг каждого факта: фраза-анонс перед ним («Итераторы относятся к фундаментальным концепциям Python, применяемым ежедневно…»), оценочное подмигивание внутри («не формальность», «честно», «с которого стоило начать») и афоризм после («Навык программирования от чтения не появляется»). Плюс антитезы с соломенным чучелом («Git как рабочий инструмент, а не набор заученных заклинаний») и метафоры в кавычках («посчитал за обед»).

Рамки сняты, факты оставлены. Три волны, 75 глав, объём прозы 83 000 → 72 200 слов (−13 %). Блоки кода, заголовки, адреса ссылок, формулы, числа и инлайн-код сверены с прежней версией побайтно. После каждой волны дифф вычитывался на потерю факта, разрыв связи и грамматику; найдено и починено 43 поломки, почти все — обрубки после снятых придаточных.

на 1000 слов до после
открывашки абзацев «Дальше / Теперь / Заодно / Отдельно» 1.14 0.24
усилители «именно / ровно / вовсе / принципиально / честно» 0.89 0.18
модальное «стоит» 1.40 0.90
антитезы «не X, а Y» 1.63 1.54
канцелярское «данный» вместо «этот» 8 вхождений 0

Две вещи не улучшились, и о них честно. Доля фраз короче восьми слов выросла с 29,5 до 32,2 %: когда с длинной фразы снимаешь придаточное-подмигивание, остаётся короткое утверждение. Теперь эти короткие фразы — факты, а не афоризмы, но стаккато-ритм, если он мешал на слух, никуда не делся; лечится он обратным проходом — сращиванием, а не вычёркиванием. И плотность причастных оборотов, которую в v6.x поднимали до авторской, просела примерно на седьмую часть: часть снятой риторики сама была в них завёрнута. Частота «который» при этом не выросла, а тоже снизилась — обороты не превращались в придаточные, а уходили вместе с рамкой.

Состояние книги

77 глав, SUMMARY и файлы на диске сходятся; внутренние ссылки, якоря заголовков и пути к картинкам целы; парность блоков кода соблюдена; предметный указатель полон — 200 терминов из 200, 271 отметка; overfull-боксов 11, все — длинные URL и листинги.

Печатная вёрстка

406 страниц (было 418 в v8.0 и 428 после правок по ревью), 50,75 уч.-изд. л., 47,2 усл. печ. л. Формат А4 (60×84 1/8), полоса 170×257 мм, поля 20 мм, Times New Roman, абзацный отступ 10 мм — по требованиям ИПЦ НГУ. Объём блока чётный, колофон на последней странице.

Что заполняет автор перед сдачей

ISBN, фамилии рецензентов, номер и дату протокола кафедры, тираж, номер заказа, дату подписания в печать. В библиотеке НГУ подтвердить УДК 004.4:53(075.8), ББК 32.973-018я73 и авторский знак Ф33.