54 noticias
El uso de la wiki integrada en GitHub se considera una mala práctica (anti-pattern) debido a sus limitaciones técnicas y de control. Aunque ofrece acceso rápido desde cualquier parte del repositorio, carece de las ventajas de la documentación versionada en carpetas locales, como la capacidad de clon
El autor de este ensayo expresa su creciente frustración con la proliferación de documentos, propuestas de diseño y resúmenes de reuniones generados por inteligencia artificial, que suelen carecer de contexto y voz propia. Según sus observaciones, estos textos, aunque técnicamente precisos, resultan
Carson Gross, profesor y consultor de software, propone que el Markdown debe almacenarse en la carpeta /src junto al código generado por agentes de IA, reemplazando a los prompts efímeros como fuente de verdad. Este artículo argumenta que, aunque el código generado por LLMs es la realidad operativa
Python Iceberg es un recopilatorio didactico de comportamientos del lenguaje Python que parecen evidentes a primera vista pero esconden resultados inesperados. La pagina reune, en formato de fichas breves, decenas de casos donde la sintaxis habitual produce errores sutiles o directamente fallos de s
Intel ha puesto a disposición de la comunidad de desarrolladores un sitio web que sirve como anticipo de cómo piensa documentar en el futuro la arquitectura Intel (IA), incluido el conjunto de instrucciones Intel 64 e IA-32. El objetivo declarado de la iniciativa es ofrecer una especificación más pr
Una discusión abierta en el foro textlog, iniciada por el usuario @lemonthymeshortbread, cuestiona por qué la mayoría de las herramientas de software adoptan archivos de configuración en JSON en lugar de formatos que, como YAML o TOML, permiten documentar el porqué de cada opción. El autor original
KDE Linux, el sistema operativo de próxima generación impulsado por la comunidad KDE, registró en agosto de 2026 avances sustanciales en seguridad de datos, entrada de texto, control de calidad y documentación. El proyecto alcanzó el 85% del hito Beta. La novedad más destacada es un sistema de insta
El lenguaje de programación Janet ha alcanzado la versión 1.42.0, una actualización que llega tras un periodo prolongado de desarrollo y que reúne un volumen inusual de mejoras internas y de documentación. El comunicado oficial del repositorio en GitHub describe la entrega como una puesta al día pen
El problema XY es un patrón habitual en foros y canales de soporte técnico: la persona que pide ayuda describe el intento de solución que se le ha ocurrido, en lugar de exponer el problema de fondo que intenta resolver. Como consecuencia, quienes la ayudan invierten tiempo en una vía que no encaja c
Algunas páginas de documentación y archivos README han empezado a incluir mensajes dirigidos expresamente a los agentes de inteligencia artificial, con instrucciones del tipo "si eres un agente, sigue estos pasos". La práctica resulta incómoda para los lectores humanos y plantea dudas sobre su utili
Jamie Tanna, ingeniero de software con más de una década de experiencia escribiendo mensajes de commit detallados en Git, explica por qué mantiene esta práctica incluso en la era de los modelos de lenguaje (LLM) capaces de redactarlos automáticamente. El artículo defiende que un buen mensaje debe ce
Anthropic publica en su documentación oficial la lista de system prompts empleados por Claude, la familia de modelos de lenguaje de la compañía. Estos system prompts son las instrucciones internas que el asistente recibe al iniciar una conversación en la interfaz web (claude.ai) y en las aplicacione
sandbox.bio ofrece un script ligero que permite incrustar un terminal interactivo y ejecutable en cualquier página web o artículo de blog. Basta con añadir una etiqueta <script src="https://sandbox.bio/embed.js"> en el HTML del sitio para que el terminal aparezca en pantalla y los lectores puedan ej
La llamada ingeniería agéntica —el desarrollo de software asistido por agentes de inteligencia artificial— no exige, en realidad, prácticas nuevas: reproduce las mismas rutinas que la ingeniería de software lleva décadas recomendando y que la presión de plazos suele dejar en el cajón. El texto parte
Line9 es una herramienta para crear diagramas a partir de un código fuente declarativo basado en texto, en una filosofía similar a la de Mermaid. El usuario escribe un archivo con bloques separados por separadores `---`, indicando el tipo de diagrama (`flowchart`, entre otros), un título y un tema v
David Binder, desarrollador de la comunidad Haskell, publicó en el blog oficial del lenguaje una hoja de ruta para producir una versión revisada del Haskell 2010 Language Report, el documento normativo del lenguaje que no se actualiza desde hace 16 años. El autor sostiene que el informe se ha quedad
Effective HTML es una guía visual y práctica orientada a decidir cuándo conviene producir un artefacto en HTML —desde wireframes hasta prototipos funcionales, diagramas e interfaces pequeñas— frente a quedarse en Markdown. La premisa central es que el HTML se justifica cuando la expresión espacial,
SimpleEnglish es una habilidad (skill) para agentes de inteligencia artificial que fuerza a los modelos de lenguaje a redactar documentación técnica siguiendo el estándar ASD-STE100 (Simplified Technical English), un lenguaje controlado que el sector aeroespacial emplea desde 1983 para evitar ambigü
Espressif ha publicado una guía oficial para desarrollar aplicaciones embebidas con Rust sobre sus sistemas en chip (SoC). El libro, coordinado en el repositorio esp-rs/book, está dirigido a programadores de Rust con o sin experiencia previa en sistemas embebidos y recorre la estructura de la pila d
El paquete analysis del proyecto Go define la interfaz entre un análisis estático modular y el programa que lo ejecuta, conocido como driver. Un análisis estático es una función que examina un paquete de código Go y emite diagnósticos —generalmente errores en el código—, aunque también puede produci
librrd playground es un entorno y un lenguaje declarativo para representar diagramas, especialmente diagramas sintácticos tipo ferrocarril (railroad diagrams), acompañado de un sistema de hojas de estilo inspirado en CSS. En el lenguaje de diagramas, las estaciones terminales pueden escribirse como
iproute2 es el conjunto de herramientas de red de Linux que sustituyó a los comandos clásicos como ifconfig, route, arp, vconfig y brctl, mantenidos hoy solo por compatibilidad. Creado originalmente por Alex Kuznetsov y mantenido actualmente por Stephen Hemminger, unifica la mayor parte de la config
Trifle es una colección de gemas para Ruby descrita por su autor como una 'navaja suiza' de pequeñas herramientas orientadas a resolver problemas habituales en el desarrollo de aplicaciones. La documentación, publicada bajo licencia MIT, está organizada en cinco módulos principales: Trifle::Docs, un
Gitolite es una herramienta de código abierto que permite configurar un servidor central para alojar repositorios Git con un control de acceso granular y otras funcionalidades avanzadas. Se instala habitualmente desde el gestor de paquetes del sistema (donde suele aparecer como gitolite3) y su códig
SQLite admite caracteres NUL (0x00) en mitad de las cadenas almacenadas, pero su presencia provoca un comportamiento fácil de malinterpretar. La función length() solo cuenta los caracteres anteriores al primer NUL y devuelve la longitud hasta ese punto; lo mismo ocurre con la función quote() y con e
Command Line Interface Guidelines es una guía de código abierto, alojada en GitHub, que reúne principios de diseño y recomendaciones prácticas para crear programas de línea de comandos (CLI) modernos. Su propósito es actualizar la filosofía UNIX clásica, pensada para máquinas, a un contexto actual d
La edición acumulativa es un patrón de fallo habitual en los asistentes de inteligencia artificial que consiste en conservar la información anterior ya obsoleta y añadirsela al texto nuevo en lugar de reescribirlo. Se manifiesta cuando una herramienta de IA, encargada de actualizar un documento, mod
La mayoría de la documentación digital se organiza todavía en carpetas y jerarquías, un modelo heredado del escritorio de Xerox PARC en los años setenta pensado para oficinistas que conocían los archivadores físicos. Medio siglo después, ese símil sigue condicionando cómo estructuramos archivos, wik
Este proyecto propone un sistema ligero de documentación dentro del propio repositorio, pensado como una base de conocimiento compartida entre personas desarrolloras y agentes de IA que programan código. La idea central es que ambos trabajan mejor cuando el contexto es local, duradero y fácil de loc
Moxie Docs ofrece un editor en vivo de Mermaid gratuito y basado en el navegador que permite crear, previsualizar y exportar diagramas sin necesidad de registro ni instalación. La herramienta dibuja el diagrama a medida que se escribe el código en el panel izquierdo y muestra el resultado al instant
El contenido presentado es un texto fragmentado y de baja coherencia que combina extractos de la documentación de Git (referencias a opciones como --append, --shallow-exclude, -c/--config, variables de color, modos non-cached, HEAD detached, glosario, push y protocolos) con hashes hexadecimales y en
enioka Haute Couture, consultora francesa especializada en diseño de aplicaciones y estructuración de equipos de desarrollo, relata cómo la pérdida repentina de su Tech Lead a causa de un accidente de esquí sirvió para validar empíricamente su modelo de trabajo basado en la documentación escrita y l
Shrimple es una herramienta de línea de comandos, escrita en Go, que convierte documentos de texto plano en HTML siguiendo una sintaxis propia pensada para mantenerse limpia tanto en la fuente como en el resultado renderizado. Se distribuye como código fuente y se compila con `go build`; a partir de
Gemini Code Assist en GitHub es una herramienta de Google Cloud que integra el modelo Gemini en el flujo de revisión de pull requests. Funciona como un revisor automático basado en un agente de inteligencia artificial que resume las solicitudes de extracción y realiza revisiones de código en profund
La comunicación de modelos mentales —las representaciones internas que permiten comprender y usar un sistema— es un reto central de la educación y la ingeniería del conocimiento. Un hilo de discusión técnica explora qué métodos funcionan mejor para construir y transmitir esas estructuras cognitivas,
OpenWiki es una herramienta de línea de comandos (CLI) diseñada para escribir y mantener actualizada la documentación de un repositorio de código, con un enfoque específico en el uso por parte de agentes de inteligencia artificial. Se instala de forma global con `npm install -g openwiki` y se inicia
La programación resulta difícil de leer, probar y mantener, y solo un puñado de personas comprende cualquier proyecto software. Este artículo sostiene que el auge de los grandes modelos de lenguaje (LLM) no es la solución, sino un síntoma de que la programación se ha vuelto insoportable: stacks en c
La organización publica su política revisada el 26 de junio de 2026 sobre el uso de modelos de lenguaje de gran tamaño (LLM) en sus proyectos de código abierto. La norma prohíbe incluir contenido generado por LLM, ya sea en código o en documentación, en cualquier contribución realizada por humanos.
Un nomograma es un diagrama gráfico formado por escalas numeradas que permite resolver una fórmula matemática colocando una regla recta sobre los valores conocidos para obtener el desconocido. Estos calculadores analógicos fueron ideados en 1880 por Philbert Maurice d'Ocagne y se emplearon durante d
Mozilla ha presentado el servidor MCP de MDN, una herramienta experimental que conecta la documentación y los datos de compatibilidad entre navegadores del proyecto MDN con asistentes de programación y entornos de desarrollo compatibles con el protocolo Model Context Protocol (MCP). El objetivo es q
El número de paquetes nuevos aceptados en CRAN, el repositorio de referencia para el lenguaje R, crece a un ritmo sin precedentes, pero la pregunta de fondo es si esa expansión se traduce en aportaciones reales para la comunidad. Joseph Rickert, autor de la selección mensual "Top 40" en R Works, exp
Un repositorio de documentación técnica ofrece un mapa detallado del sistema operativo de la calculadora gráfica TI-84 Plus, obtenido mediante ingeniería inversa a partir de un volcado de flash de 1 MiB (ti84plus.rom) que se identifica como OS 2.55MP. La calculadora emplea un procesador Zilog Z80 co
Un programador describe la práctica que ha adoptado en proyectos de mayor envergadura: pedirle a Claude, el asistente de IA, que redacte documentos de traspaso y resúmenes estructurados de cada proyecto para guardarlos en el repositorio de código. La iniciativa parte de una observación irónica: los
Programming as Theory Building es un ensayo de Peter Naur que propone una perspectiva radical sobre lo que significa真正的programar. Según Naur, el objetivo central del programador no es simplemente producir código fuente, sino construir y mantener una teoría –un modelo mental– del sistema, de sus requ
## SDocs: Documentación como Código para Infraestructuras Modernas SDocs es una herramienta innovadora que permite tratar la documentación de tu infraestructura (especialmente en entornos Kubernetes y cloud computing) como código. Tradicionalmente, la documentación se crea y mantiene en formatos co
Un artículo reciente cuestiona la relevancia actual de la metodología Agile en el desarrollo de software, argumentando que sus principios no eran novedosos y que el propio manifiesto Agile carece de claridad y especificidad. El autor señala que Agile fue definido principalmente como lo que *no* era
El artículo "Peligro Tecnológico Puro" presenta el llamado "Principio de Miller", una observación irónica pero sorprendentemente precisa sobre el comportamiento humano en el ámbito tecnológico. En esencia, el Principio de Miller afirma: **nadie lee nada**. Esto no es una crítica personal, sino una c
## ¿Necesitan proyectos de código abierto escritores de documentación? Una mirada a Scrutiny y la importancia de la documentación técnica **Introducción:** En el mundo del software de código abierto, la calidad del código es solo una parte de la ecuación. Una documentación clara, completa y accesi
Este contenido, originado en una Solicitud de extracción (PR) en GitHub, aborda un problema sutil pero común en el mundo del desarrollo de software: la proliferación de un lenguaje inflado y poco claro, a menudo denominado "Linkedin-speak", en la documentación técnica, específicamente en el archivo
A medida que los equipos de desarrollo integran modelos de lenguaje grandes (LLM) para la generación de código, la gestión de la documentación se ha convertido en un desafío creciente. El artículo de Jim Yagmin en yagmin.com describe cómo la acumulación de documentación en directorios como `/docs`,
El artículo explora la revitalización de la 'programación legible' (programación legible) en la era de los agentes de inteligencia artificial (IA). La programación legible, una técnica donde el código se entrelaza con prosa explicativa, permite que incluso personas no expertas comprendan el funciona
Este artículo de Ellane W. aborda un problema común: olvidar cómo realizar tareas que realizamos con cierta frecuencia, especialmente aquellas que no repetimos regularmente. El ejemplo inicial es la preparación de un PDF para una demostración, un proceso que, aunque conocido, requirió un esfuerzo co
En el mundo del desarrollo de software, la productividad y la claridad mental son cruciales. Un número sorprendentemente bajo de ingenieros utilizan una práctica que puede mejorar significativamente ambos: el uso de un cuaderno de ingeniería físico. Este artículo explora esta técnica, que consiste e
El artículo argumenta que la documentación tradicional de APIs es un punto de fallo, ya que tiende a desincronizarse con el código. Propone una alternativa: "ship types" (enviar tipos) en lugar de documentación. Esto significa definir contratos de API a través de tipos de datos, que son ejecutables
