Прочитал «Если ты — технический писатель» Кати Ушаковой

Наконец дошли руки до книги @ringova, которую я заказал ещё из первого тиража. Книга мне понравилась по соотношению объема и пользы — чтение, запись заметок и написание этого поста заняли у меня 4 часа, требующихся на дорогу до Москвы в Сапсане.

Я читал эту книгу в первую очередь как ментор, чтобы найти какую-нибудь универсальную рекомендацию для тех, кто хочет вырасти сам и помочь правильно настроить процессы в своих компаниях.

Есть несколько причин, по которым я хочу похвалить эту книгу. Первая и главная — она действительно современная. Это видно по языку, включая сленг и отсылки, но что важнее — в центре внимания документация, которая изначально создается в веб-формате, распространяется в онлайне и существует в актуальной продуктовой среде, например опирается на CJM.

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

Это вещи, из-за которых прочитанное понравилось именно мне (ещё, конечно, обзор метрик, неприятие FAQ как формата современной документации и лишь одно использование аббревиатуры «ИИ» за всю книгу). А вот джуниорам и мидлам я рекомендовал бы её из-за количества практических рекомендаций, которых там много практически на любой случай и в любых формах. Есть, правда, и неожиданные моменты. Совсем начинающие могут быть удивлены тем, что чек-лист для ревью с базовыми пунктами встречается на 98-й странице, а рекомендации по анализу логов поведения пользователей и А/Б-тестированиям — на 51-й. Я предполагаю, что это может быть хорошим заделом для повторного прочтения в будущем, тем более что книга сама по себе совсем небольшая — 122 страницы прочитает любой писатель.

Короче, рекомендую. Не так много про нас пишут в целом, а про то, как действительно обстоят дела в нашей сфере во второй четверти XXI века и как со всем этим быть, пока не писали вообще.