En el desarrollo de software, recopilamos antipatrones para reconocer rasgos comunes que conducen a malos resultados. Pensé que sería útil hacer lo mismo para los blogs de software, así que he catalogado los errores más frecuentes que veo en los blogueros principiantes.
El error más común es divagar. A los desarrolladores les encanta la especificidad, por lo que comienzan las publicaciones del blog con antecedentes e contexto histórico. Eso puede ser divertido de escribir, pero no siempre es interesante de leer. Desde la perspectiva del lector, hay mil millones de otros artículos que podrían estar leyendo. Date el título y las primeras tres oraciones para responder: ¿El autor escribió esto para alguien como yo? ¿Cómo me beneficiaré al leerlo?
Algunos blogueros escriben una introducción convincente pero saturan el camino del lector con extras como un subtítulo, una biografía o una imagen. Todo lo que pongas en el camino del lector resta valor a su suministro finito de enfoque. Los maestros efectivos comparan conceptos nuevos con algo que el lector encuentra familiar. Por ejemplo, si estuvieras explicando Jellyfin, podrías decir: "Jellyfin es un servicio de transmisión como Netflix, excepto que es de código abierto y privado". Minimiza tus suposiciones sobre el lector.
Cuando escribas una publicación de blog, piensa en tu lector objetivo. ¿Qué saben? Imagina a un amigo o compañero de equipo que conoces en la vida real. Escribe una lista de términos que reconocerían y términos que no.
Fuente: Hacker News · Resumido por HeadlinesBriefing