Michael Lynch cataloga 8 anti-patterns del blogging tech

El blogging técnico se está volviendo aburrido (y la IA tiene la culpa)

Michael Lynch, ex-ingeniero de Microsoft y Google y autor de Refactoring English: Effective Writing for Software Developers, lleva años observando algo que muchos lectores sienten pero pocos saben explicar: el software blogging se está volviendo anodino. La razón, dice, es que demasiados desarrolladores delegan la escritura en herramientas de inteligencia artificial, y el resultado es un contenido correcto, predecible y sin voz propia.

En su artículo "Anti-Patterns in Software Blogging", Lynch cataloga los errores más comunes que cometen quienes escriben sobre desarrollo de software. La lista no es genérica: apunta a vicios muy específicos que, según el autor, alejan a los lectores en los primeros segundos. Simon Willison, otro conocido blogger técnico, recogió el post y señaló como autocrítica el cuarto anti-pattern — el exceso de enlaces como excusa para no explicar términos — que él mismo reconoce practicar.

Veamos los ocho anti-patterns y, sobre todo, qué hacen los founders con ellos en la práctica.

Introducción errante: el error que más se repite

Para Lynch, el peor y más frecuente de los vicios es la "introducción meandering": párrafos de backstory, contexto histórico o divagaciones antes de que el lector sepa de qué va el artículo. "Los desarrolladores adoran la especificidad, así que empiezan con antecedentes y todo lo que se les pase por la cabeza. Es divertido de escribir, pero no siempre de leer", escribe en Refactoring English.

La regla que propone es concreta: el título y las tres primeras oraciones deben responder dos preguntas del lector — "¿esto es para mí?" y "¿qué gano si lo leo?". Si no responden alguna, el lector se va. En el podcast tmpdir.org episodio 53, Lynch describió este patrón como el más grave y lo comparó con la pirámide invertida del periodismo: hay que decir primero por qué importa, después el cómo.

Asumir lo que el lector sabe (o no sabe)

El segundo anti-pattern es la asimetría de conocimiento. Lynch pone el ejemplo de explicar Docker asumiendo que el lector ya conoce cgroups, jails de BSD o incluso qué es Linux — términos que un principiante del tema no reconocerá. La solución: imaginar un lector real (un amigo, un colega) y hacer una lista explícita de qué sabe y qué no, para releer el borrador con esa lista en mano.

Tyler Cipriani, al que Lynch editó, lo resume así: "Comparar tu lista con las suposiciones de tu borrador es una experiencia reveladora".

Enlaces como atajo, no como bonus

El tercer punto duele especialmente a bloggers técnicos: enlazar términos sin explicarlos. "El lector no quiere interrumpir su lectura para irse a leer otro sitio solo porque pusiste un link", argumenta Lynch. Su regla: el artículo debe entenderse completo sin hacer clic en nada; los enlaces son bonus, no prerrequisitos. Si quieres hablar de un firewall, explica en una frase qué hace, y luego, si quieres, enlaza a la documentación de 20.000 palabras.

La secuela que nadie pidió

Lynch bautiza como "sequel injection bug" a los posts que abren con "en la parte uno aprendimos X; hoy hablaremos de Y". El problema: la mayoría de los lectores no leyeron la parte uno. Sugiere tratar cada post como autónomo y, si necesitas remitir a otro, resumir lo relevante en una o dos frases, no obligar al lector a irse a leer todo el artículo previo.

Formalidad impostada

El quinto anti-pattern ataca el tono. Lynch cita la frase "Several static analysis tools were utilized by my teammates and myself throughout the duration of this project's lifetime" como ejemplo de escritura rígida y artificial. "No estás escribiendo para ejecutivos de IBM de 1988. Tu campo es el desarrollo de software, uno de los trabajos de cuello blanco menos pretenciosos. Escribe como hablas", resume.

Y aquí vuelve la IA. Lynch advierte que, con tantos desarrolladores delegando la escritura en herramientas como ChatGPT o Claude, el blogging técnico se está volviendo "blando y homogéneo". Los lectores, dice, tienen hambre de personalidad. Como referencia, cita a Joel Spolsky, Kathy Sierra, Terence Eden y Raymond Chen — autores que suenan como ellos mismos, no como plantillas.

En el podcast, Lynch fue más allá: su regla personal es que la IA actúe como profesor, nunca como ghostwriter. "La IA no debería escribir dentro de tus documentos", resume. Apoyarse en ella para mejorar el texto está bien; dejar que lo genere te estanca en un máximo local.

Basics que se ignoran: mobile y tipografía

Los dos últimos anti-patterns no son de contenido, son de forma. Lynch se frustra al ver blogs que rompen en móvil por una imagen o un snippet de código que insiste en ser tamaño desktop. "Revisa tu artículo en el modo móvil de Chrome o Firefox antes de publicar", recomienda. Y aporta un dato: en su propio blog, el 35% de las visitas llegan desde teléfonos; en el artículo de anti-patterns, el 25%.

En tipografía, la queja es la combinación de gris claro sobre fondo gris claro. Lynch recomienda el navegador para detectar bajo contraste y, si no quieres complicarte, instalar Atkinson Hyperlegible, una fuente gratuita del Braille Institute pensada para ser legible incluso con baja visión.

¿Qué significa esto para tu startup?

Si tu startup depende de contenido técnico para captar desarrolladores — documentación, blog posts, changelogs, tutoriales —, esta lista no es académica. Es una lista de cosas que están haciendo que tu página rebote antes de los diez segundos.

• Audita tus tres primeros posts del blog. ¿Las tres primeras oraciones responden a "¿es para mí?" y "¿qué gano?". Si no, reescríbelas. La mayor parte del trabajo de retención pasa ahí, no en el cuerpo del artículo.
• Separa el rol de la IA: profesora, no ghostwriter. Úsala para cuestionar suposiciones sobre el lector, para detectar términos sin explicar y para auditar contraste visual. No le pidas que escriba el post. La homogeneidad es el nuevo ruido.

La apuesta de Lynch es clara: en un mar de contenido generado por máquinas, la voz propia es ventaja competitiva. Escribir como hablas no es unprofessional; es la única manera de que un lector recuerde que existes.

Fuentes

• Anti-Patterns in Software Blogging — Simon Willison
• Anti-Patterns in Software Blogging — Refactoring English (Michael Lynch)
• Refactoring English: Writing and Self-Publishing with Michael Lynch — tmpdir.org