Anti-patrones en los blogs de software
Los blogs de software y desarrollo son criticados cada vez más por “introducciones divagantes”, ledes enterrados, enlaces excesivos como deberes y tutoriales que asumen que los lectores conocen “todo menos esta cosa”. Los comentaristas sostienen que una buena escritura técnica debería poner por delante la idea clave, indicar claramente los prerrequisitos, respetar el tiempo del lector y dejar clara la experiencia del autor, sin dejar de permitir personalidad y narración cuando sea apropiado para la audiencia. El hilo también analiza cómo los grandes modelos de lenguaje están sustituyendo las preguntas y respuestas al estilo de Stack Overflow, lo que eleva la exigencia de que las publicaciones escritas por humanos aporten una visión genuina, contexto y orientación actualizada en lugar de texto genérico al estilo de la IA.
Introducciones divagantes y narración de historias
- A muchos comentaristas no les gustan las introducciones largas y llenas de suspense en textos técnicos; quieren el punto central y la propuesta de valor al principio (“no entierres el tema principal”).
- Otros sostienen que contar historias puede ayudar al compromiso y a la comprensión, especialmente cuando los lectores están en modo “aprender + entretenimiento” en lugar de resolver problemas con un objetivo concreto.
- Varios distinguen entre formatos: las publicaciones de búsqueda de fallos o narrativas pueden sostener más historia; los tutoriales, las referencias y las noticias deberían ir directos al grano.
- Hay preocupación de que “escribe cada frase solo para que el lector siga leyendo” pueda convertirse en clickbait, cebo para la interacción o “AI slop”, salvo que esté anclado en un valor genuino.
Audiencia, propósito y estilo
- Un tema recurrente: todo depende del contexto. Una buena estructura depende de la audiencia (SWE al estilo HN, PhDs, lectores ocasionales, aficionados) y de la intención (enseñar rápido, provocar reflexión, entretener).
- Algunos prefieren una prosa neutral y objetiva; otros gustan de una fuerte personalidad. Tanto un tono demasiado informal como uno demasiado formal pueden resultar incómodos, según el gusto.
- Los consejos de escritura se ven como orientación, no como ley. Varias personas recalcan “tomar todas las reglas con cautela”.
Voz y autoridad: principiante vs experto
- Un gran anti-patrón: “lo hice una vez, ahora soy un experto”. Los lectores objetan cuando experimentos tentativos de fin de semana se presentan como la mejor práctica autoritativa.
- A muchos aún les gusta que los principiantes escriban, pero que enmarquen claramente las publicaciones como notas, experimentos o comprensión parcial.
- Buena práctica: compartir incertidumbres y preguntas abiertas explícitamente, en lugar de generalizar en exceso a partir de una sola experiencia.
Enlaces, prerrequisitos y mantenimiento
- La sobredependencia de enlaces sin resúmenes convierte las publicaciones en “bosques de deberes”. Se prefiere resumir los conceptos enlazados o citar partes clave.
- Un fallo importante es asumir “el lector sabe todo lo que yo sé excepto una cosa”. Los lectores quieren comparaciones con herramientas conocidas y una motivación clara.
- Los tutoriales desactualizados (por ejemplo, para versiones antiguas de un framework) son una frustración común; las soluciones sugeridas incluyen actualizaciones o avisos explícitos de obsolescencia.
LLMs, Stack Overflow y el valor de los blogs
- Algunos dicen que los LLMs han sustituido en gran medida a Stack Overflow y a muchos blogs de desarrollo para respuestas rápidas; otros se preguntan de dónde obtendrán los LLMs conocimiento fresco y de alta calidad si foros y blogs declinan.
- Varios siguen viendo un gran valor en los blogs: contexto más profundo, perspectivas personales y como herramienta de pensamiento para el autor.
- Hay una desconfianza notable hacia las publicaciones generadas por LLMs, percibidas como verbosas, genéricas y a menudo con poco contenido sustancial.
Blogs personales vs contenido productizado
- Una postura: un blog es personal; no hay “anti-patrones” si el autor no está optimizando para crecimiento o audiencia.
- Otra postura: incluso en sitios personales, siguen existiendo malos patrones de escritura, especialmente si las publicaciones se comparten ampliamente e influyen en las prácticas de la comunidad.