Как за 20 минут улучшить айтишный текст, если у вас нет редактора

Чек-лист для технических специалистов и всех страдающих.

Как работать с чек-листом. В нем всего четыре пункта. Откройте свой текст, рядом чек-лист. Двигайтесь по пунктам. Прочитали один пункт — сделали сверку с текстом, поправили. Так со всеми пунктами.

1. Заменяем множественное число на единственное — везде, где это возможно, особенно в примерах и описаниях.

Так мы резко уменьшаем уровень абстракции и приземляем текст. Мы даем понять читателю, что разбираем не гипотетические ситуации, а конкретные примеры из нашего или его опыта.

2. Убираем эмоции. Эмоциональная оценка не добавляет в текст ценность —  она ее уменьшает.

Примеры:

🔘фантастическая скорость обработки данных
🔘невероятная гибкость настройки
🔘восхитительный интерфейс
🔘ошеломляющая производительность сервера

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

А если вы не знаете, почему так написали, — просто удалите оценку и все. Это называется удалить из текста без потери смысла. Прием работает в любых правилах и советах.

3. Убираем глаголы со словом «был». Надоело читать и писать про пассивные глаголы, объясню по-другому.

Принцип простой — вместо кем-то был изменен пишем кто именно изменил.

🔘Файл конфигурации был изменён.
🔘Разработчик изменил файл конфигурации.

🔘Ошибки были обнаружены во время тестирования.
🔘Тестировщики обнаружили ошибки во время тестирования.

4. Убираем деепричастия и причастия. Лица числа и даже слова в исправлениях могут меняться, это зависит от контекста. Главное — просто уберите их.

🔘функция, реализованная в последней версии библиотеки
🔘новая функция

🔘проведя анализ логов
🔘провел анализ логов (и выяснил)

Ну вы поняли.

В чем хорош чек-лист. Это проверенный быстрый способ значительно упростить текст, точнее передать смысл и даже заглянуть в мир читателя. Не нужно ничего выдумывать, сильно переписывать и страдать.

В чем плох чек-лист. Если в тексте нет смысла, он там не появится. Логические ошибки не исправятся. Волшебства не случится.

Для того, чтобы писать сильные тексты, нужно кое-что еще — об этом в следующий раз.

Современная русская литература: Донцова и остальные

22% россиян считают, что русская литература сегодня находится на подъеме.
43% говорят, что, напротив, она в упадке.

Среди молодежи (до 30 лет) голоса распределяются примерно пополам, но чем старше россияне, тем чаще они считают, что русская литература находится в упадке.

🔹 На просьбу ФОМ назвать современных русскоязычных авторов, которые вам известны или хотя бы о ком россияне что-то слышали, 62% затруднились с ответом, а еще 9% сказали, что таких нет.

Среди тех, кто называл авторов, чаще всего называли Дарью Донцову. Топ-10 выглядит так:

1️⃣ Д. Донцова (5%)
2️⃣ З. Прилепин (4%)
3️⃣ В. Пелевин (3%)
4️⃣ Т. Устинова (2%)
5️⃣ Б. Акунин (иноагент) (2%)
6️⃣ А. Маринина (1%)
7️⃣ А. Лукьяненко (1%)
8️⃣ Е. Водолазкин (1%)
9️⃣ Д. Глуховский (иноагент) (1%)
🔟 Ю. Шилова (1%)

6% называли каких-то других русских или советских авторов,
9% – других современных русскоязычных авторов

📊 Опросы и замеры

Когда вижу новости, что Донцова опять заняла первое место в каком-то книжном топе и как это плохо, всегда вспоминаю выпуск «Школы злословия» с ее участием.

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

С 2002 года все сильно изменилось, даже на журфаке ходили слухи про аспирантов, которые с чем-то там кому-то помогали.

Но эта передача навсегда отбила желание модно грустить по поводу чьих-то книжных вкусов.

Посмотрите, может и вам понравится:
https://youtu.be/h-EBRuMxRiM?si=i6MPi9gMR6A3CTEH

Топ-менеджерам, айтишникам, обычным людям не нужен «свой» язык, им нужен человеческий язык.

Если только вы не доказываете гипотезу Пуанкаре или не оформляете налоговый вычет.🙂

В разгар праздников состоялся у нас с пользователем из песочницы бурный и отчасти недружеский диалог. А поссорил нас искусственный интеллект. Вот в чём проблема: автор «завёл» в генеративную модель свои промты, получил сложный текст с канцеляризмами, бюрократическими оборотами и сложными конструкциями. Он считал, что это ничего страшного, текст предназначен топ-менеджерам. Текст на Хабр, конечно, не вышел. Но вот в чём история. А и правда, нужен ли отдельный текст для топ-менеджеров?

В научной среде, например, так принято: говорить и писать определёнными конструкциями на языке терминов. Во многом это нужно для единства понимания, интерпретации и перевода.

В бизнес-среде даже топ-менеджеры используют простой, доступный язык с включениями профессиональных отраслевых терминов. Более того, нередко на конференциях удаётся заметить: если спикер говорит путано, сложно и в сплошных терминах, скорее всего, он боится быть понятым и не хочет дополнительных вопросов. Но это в общении. На письме у многих дела обстоят гораздо хуже:
исходя из вышеописанного, обратите внимание на нижеследующие детерминанты развития ERP-систем в условиях цифровой трансформации и переопределения констант актуального состояния рынка систем управления ресурсами организаций.
Конечно, в этой фразе всё понятно, но она уродлива как для отраслевого журнала, так и для Хабра.

И вот здесь мы подходим ещё к одной опорной точке: важно не только для кого мы пишем, но и где. Например, на Хабр топ-менеджеры заходят почитать интересные статьи в момент отдыха или в минуту прокрастинации – вряд ли им захочется продираться сквозь дебри текста. Собственно, отраслевые журналы тоже читали бы от корки до корки, если бы тексты были читабельными. Но там чаще всего всё очень грустно.

Наконец, важно, а готов ли сам автор потрудиться и изложить доступно, лаконично, понятно и в то же время серьёзно? Это тоже требует опыта и глубокого знания предмета.

Готовлю сейчас серию семинаров по контенту для IT-специалистов — в том числе про логические основы редактирования текста.

Законы логики работают и для точных предметов, и для гуманитарных. Поэтому на них проще показать технарям, зачем нужны редакторы и что такое сильный текст.

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

Если вы видели что-то про логику в популярных курсах и книгах про тексты, напишите, пожалуйста, в комментариях — очень хочется такие найти!