Anti-patterns in software blogging
Главная ошибка в техническом блоге — затянутое введение, которое не отвечает на вопросы: «Это для меня?» и «Что я получу?». Автор советует сразу показать ценность: научить навыку, объяснить концепцию или дать новый взгляд. Пример: статья о Go-тестах начинается с чёткого предложения — «Я научу вас за 30 секунд». Всё, что отвлекает от сути (подзаголовок, биография, цитата), тратит внимание читателя и считается частью затянутого введения.
Другая частая проблема — предположение, что читатель знает всё, кроме одной детали. Нужно явно объяснять базовые понятия, сравнивая с известным (например, Docker как интерфейс к cgroups). Также важно не перегружать пост ссылками — они должны быть дополнением, а не обязательными для понимания. Следует избегать продолжений предыдущих постов без контекста, писать просто и разговорно, проверять отображение на мобильных устройствах (нет горизонтальной прокрутки) и контраст шрифта (например, Atkinson Hyperlegible для лучшей читаемости). Цель — сделать пост доступным и полезным с первого взгляда.