В разработке программного обеспечения мы собираем антипаттерны, чтобы распознавать общие черты, ведущие к плохим результатам. Я подумал, что было бы полезно сделать то же самое для блогинга о программном обеспечении, поэтому я каталогизировал наиболее частые ошибки, которые я вижу у начинающих блогеров.
Самая распространенная ошибка — это отклонение от темы. Разработчики любят конкретику, поэтому они начинают посты в блоге с предыстории и исторического контекста. Это может быть весело писать, но не всегда интересно читать. С точки зрения читателя, есть миллиарды других статей, которые они могли бы читать. Дайте себе заголовок и первые три предложения, чтобы ответить: Написал ли автор это для кого-то вроде меня? Какую пользу я получу от его прочтения?
Некоторые блогеры пишут убедительное введение, но загромождают путь читателя дополнительными элементами, такими как подзаголовок, биография или изображение. Все, что вы ставите на пути читателя, истощает его ограниченный запас концентрации. Эффективные учителя сравнивают новые концепции с чем-то знакомым читателю. Например, если бы вы объясняли Jellyfin, вы могли бы сказать: «Jellyfin — это стриминговый сервис, как Netflix, за исключением того, что он с открытым исходным кодом и приватный». Минимизируйте свои предположения о читателе.
Когда вы пишете пост в блоге, думайте о своей целевой аудитории. Что они знают? Представьте друга или товарища по команде, которого вы знаете в реальной жизни. Напишите список терминов, которые они узнают, и терминов, которые они не узнают.
Источник: Hacker News · Сводку подготовил HeadlinesBriefing