Los desarrolladores de software suelen compartir conocimientos mediante entradas de blog, pero muchos caen en trampas evitables que reducen la efectividad de su escritura. El error más común, con diferencia, son las introducciones demasiado extensas, donde los autores dedican demasiado tiempo al contexto antes de llegar al punto. Como señala el autor de *Refactoring English*, los lectores frecuentemente se encuentran varios párrafos dentro de una publicación sin saber qué intenta decirles el autor. Los desarrolladores quieren saber rápidamente si un artículo les resulta relevante y qué obtendrán al leerlo, por lo que el título y las primeras tres frases deberían responder: '¿El autor escribió esto para alguien como yo?' y '¿Cómo me beneficiaré al leerlo?'. Esta situación se ilustra en la imagen que representa el concepto de demasiado preamble (IMG-002), mientras que la imagen que muestra el comportamiento de lectura de los desarrolladores (IMG-001) refuerza la necesidad de ir directo al grano.
Otro anti-patrón significativo es la dependencia excesiva de enlaces para explicar términos en lugar de ofrecer breves explicaciones en línea. Los bloggers a menudo quieren mencionar un término que el lector podría desconocer, pero en lugar de proporcionar una definición breve, colocan un enlace sobre el término y dan el problema por resuelto. Sin embargo, esto obliga a los lectores a interrumpir su flujo y abandonar el artículo para comprender una sola palabra, lo que genera una mala experiencia de lectura. La solución consiste en resumir la información esencial necesaria para seguir el artículo y tratar los enlaces externos como material complementario, no como requisito previo, garantizando que los lectores puedan disfrutar y comprender el contenido desde el principio hasta el final sin necesidad de hacer clic en ningún enlace.
Esta imagen se relaciona con el punto del artículo sobre el deseo de los desarrolladores de evaluar rápidamente la relevancia y el beneficio de un artículo, lo que debería ser evidente en el título y las primeras frases.
Esta imagen ilustra el anti-patrón de introducciones extensas donde los autores dedican demasiado tiempo al contexto antes de llegar al punto, como se discute en el artículo.
La excesiva formalidad también es un problema frecuente, ya que los principiantes en el blogging de software creen erróneamente que deben escribir de manera rígida y demasiado formal para ser tomados en serio. En realidad, el campo del desarrollo de software es uno de los trabajos de oficina menos pretenciosos, y los lectores a menudo llevan pijama y chanclas mientras comen cereal frente al teclado. No esperan ni desean una escritura que suene como un documento legal. En cambio, los bloggers deberían escribir como hablan en la vida real, adoptando un estilo casual, personal y sin pretensiones que parezca contar una historia a amigos durante el almuerzo, tal como lo hacen reconocidos bloggers de software como Joel Spolsky, Kathy Sierra, Terence Eden y Raymond Chen.