https://valoryx.org/es/blog/ Recent content in Blog on Valoryx Hugo es Mon, 13 Apr 2026 00:00:00 +0000 https://valoryx.org/es/blog/ai-native-documentation/ Mon, 13 Apr 2026 00:00:00 +0000 https://valoryx.org/es/blog/ai-native-documentation/ La documentación tiene un problema de mantenimiento. Usted escribe una guía, la publica y en tres meses está desactualizada. La API cambió. El formato de configuración fue refactorizado. Una dependencia fue reemplazada. Las capturas de pantalla muestran una interfaz que ya no existe. La solución no es “escribir mejor documentación” ni “construir una cultura de documentación”. Los equipos llevan décadas intentando eso. La solución es hacer que la documentación sea consciente del código que describe — para que cuando el código cambie, la documentación lo sepa. https://valoryx.org/es/blog/documentation-platform-cost/ Thu, 09 Apr 2026 00:00:00 +0000 https://valoryx.org/es/blog/documentation-platform-cost/ Los precios por usuario parecen razonables a primera vista. ¿Cinco usuarios a $8/mes? Son $40. Su equipo puede pagar $40. Pero la documentación es una de esas herramientas donde el número de personas que deberían tener acceso sigue creciendo. Los ingenieros necesitan escribir. Los gerentes de producto necesitan revisar. El personal de soporte necesita consultar. Los nuevos empleados necesitan leer y anotar. De repente no está en 5 puestos — está en 50, y esos “asequibles” $8/puesto son $400/mes por una herramienta que almacena archivos de texto. https://valoryx.org/es/blog/docs-for-open-source/ Mon, 06 Apr 2026 00:00:00 +0000 https://valoryx.org/es/blog/docs-for-open-source/ Los proyectos de código abierto viven o mueren por su documentación. Una biblioteca con buena documentación se adopta. Una biblioteca con un README básico y una actitud de “mire el código” es bifurcada por alguien que escribe mejor documentación — o simplemente ignorada. Pero la mayoría de las herramientas de documentación están construidas para empresas, no para mantenedores de OSS. Cobran por usuario, por página o por workspace. Para un proyecto mantenido por voluntarios con presupuesto cero, eso es inaceptable. https://valoryx.org/es/blog/documentation-search-works/ Thu, 02 Apr 2026 00:00:00 +0000 https://valoryx.org/es/blog/documentation-search-works/ Usted escribe una consulta en la barra de búsqueda de su documentación. Aparecen resultados. Pero, ¿qué sucedió entre la pulsación de tecla y los resultados? Para la mayoría de las plataformas de documentación, la respuesta es “no mucho” (coincidencia básica de palabras clave que no encuentra resultados obvios) o “mucha infraestructura” (un clúster de Elasticsearch que su equipo de operaciones tiene que mantener). Hay un punto intermedio que la mayoría de los equipos desconoce: la búsqueda de texto completo embebida. https://valoryx.org/es/blog/single-binary-architecture/ Mon, 30 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/single-binary-architecture/ La mayoría de las plataformas de documentación se distribuyen como un stack. Obtiene una aplicación Node.js, una base de datos PostgreSQL, una caché Redis, un clúster de Elasticsearch para búsqueda y un proxy inverso Nginx para unirlo todo. Cinco servicios, cinco cosas que pueden fallar, cinco cosas que monitorear, parchear y actualizar. DocPlatform se distribuye como un archivo. Descárguelo, ejecútelo, listo. Esto no es un truco de marketing. Es una decisión de arquitectura que tomamos desde el día uno, y cada decisión de diseño desde entonces se deriva de ella. https://valoryx.org/es/blog/keep-docs-up-to-date/ Thu, 26 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/keep-docs-up-to-date/ Todo equipo de ingeniería tiene el mismo problema de documentación. Alguien escribe documentación exhaustiva durante un lanzamiento. Seis meses después, la API ha cambiado, el formato de configuración es diferente y tres páginas referencian una funcionalidad que fue renombrada. Nadie actualizó la documentación porque actualizarla es una tarea separada de escribir código, y las tareas separadas se olvidan. El consejo habitual — “haga de la documentación parte de su cultura” — no funciona. https://valoryx.org/es/blog/docs-regulated-industries/ Mon, 23 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/docs-regulated-industries/ Si trabaja en salud, defensa, finanzas o cualquier industria donde la residencia de datos importa, ya ha tenido la conversación: “¿Podemos usar esta herramienta SaaS, o necesita pasar por una revisión de seguridad de seis meses?” Para la mayoría de las plataformas de documentación en la nube, la respuesta es la revisión — y a menudo termina con “no”. El problema no es que las herramientas en la nube sean inseguras. https://valoryx.org/es/blog/bidirectional-git-sync/ Thu, 19 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/bidirectional-git-sync/ Toda plataforma de documentación con una página de integración con git hace la misma promesa: su documentación vive en git, su equipo edita en el navegador y todo se mantiene sincronizado. En la práctica, la mayoría de estas integraciones son espejos unidireccionales que se rompen en el momento en que dos personas editan desde direcciones diferentes. Escribimos sobre por qué esto sucede en un artículo anterior. Este profundiza en la solución: cómo Valoryx implementa la sincronización bidireccional usando el patrón Content Ledger, y por qué este enfoque maneja los escenarios que rompen otras herramientas. https://valoryx.org/es/blog/mcp-documentation-guide/ Mon, 16 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/mcp-documentation-guide/ Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA interactuar con herramientas externas y fuentes de datos a través de una interfaz estructurada. En lugar de copiar texto en una ventana de chat y esperar que el modelo entienda el contexto, MCP le da al asistente acceso directo y tipado a sus sistemas — leer archivos, ejecutar búsquedas, crear contenido, todo mediante llamadas a herramientas bien definidas. https://valoryx.org/es/blog/internal-docs-developers-use/ Thu, 12 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/internal-docs-developers-use/ Toda organización de ingeniería tiene documentación interna. Y en la mayoría de ellas, esa documentación está incompleta, desactualizada o ignorada. Según la Encuesta de Desarrolladores Stack Overflow 2024, una mayoría de desarrolladores consideran la documentación deficiente o ausente como una barrera significativa de productividad. Esto no es un problema de disciplina. Es un problema de herramientas. La documentación interna falla por razones específicas y corregibles. Las herramientas hacen que escribir sea doloroso. https://valoryx.org/es/blog/docs-should-be-in-git/ Mon, 09 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/docs-should-be-in-git/ Este es un inventario de lo que un equipo de ingeniería típico mantiene en git: Código fuente de la aplicación Definiciones de infraestructura (Terraform, Pulumi, CloudFormation) Configuraciones de pipelines de CI/CD Scripts de migración de base de datos Especificaciones de API (OpenAPI, protobuf) Manifiestos de despliegue (Kubernetes, Docker Compose) Plantillas de configuración de entornos Y esto es lo que generalmente vive fuera de git: Documentación Esto es extraño. La documentación describe el sistema. https://valoryx.org/es/blog/documentation-as-code/ Thu, 05 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/documentation-as-code/ “Documentación como código” se menciona mucho. En su forma más simple, significa tratar la documentación de la misma manera que el código fuente: almacenada en control de versiones, escrita en texto plano, revisada mediante pull requests y construida a través de CI/CD. Pero hay una brecha entre la idea y hacerlo bien en la práctica. Esta guía cubre qué es docs-as-code, qué enfoques existen y dónde falla cada uno. Por qué importa docs-as-code Los equipos de software ya tienen flujos de trabajo para gestionar cambios. https://valoryx.org/es/blog/self-host-docs-5-minutes/ Mon, 02 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/self-host-docs-5-minutes/ La mayoría de las herramientas de documentación autoalojadas requieren una base de datos, un proxy inverso y media tarde de edición de YAML antes de ver una pantalla de bienvenida. DocPlatform es un único binario de Go sin dependencias externas. Este tutorial le lleva desde cero hasta documentación publicada en aproximadamente cinco minutos. Requisitos previos Necesita una máquina con Linux, macOS o Windows. Eso es todo. Sin Docker, sin PostgreSQL, sin runtime de Node. https://valoryx.org/es/blog/notion-alternative-self-hosted/ Sun, 01 Mar 2026 00:00:00 +0000 https://valoryx.org/es/blog/notion-alternative-self-hosted/ Notion está en todas partes. Los equipos de ingeniería lo utilizan cada vez más para documentación técnica. Funciona, hasta cierto punto. Lo Que Notion Hace Bien Editor rápido y flexible. Vistas de base de datos útiles. Adecuado para documentación no técnica. Dónde Notion Se Queda Corto Sin integración con Git. Los documentos viven en la base de datos propietaria de Notion, desconectados de tu código fuente. La desincronización de la documentación es casi inevitable. https://valoryx.org/es/blog/self-hosted-docs-guide/ Fri, 27 Feb 2026 00:00:00 +0000 https://valoryx.org/es/blog/self-hosted-docs-guide/ La documentación self-hosted está viviendo su momento. Después de años de plataformas SaaS subiendo precios, cambiando condiciones y cerrando sin previo aviso, cada vez más equipos optan por gestionar su propia infraestructura de documentación. Las razones son claras: propiedad de los datos, control de costos, cumplimiento normativo y la tranquilidad de saber que tu base de conocimiento no desaparecerá cuando una startup se quede sin financiación. Pero el ecosistema de documentación self-hosted es amplio y confuso. https://valoryx.org/es/blog/gitbook-vs-valoryx/ Wed, 25 Feb 2026 00:00:00 +0000 https://valoryx.org/es/blog/gitbook-vs-valoryx/ GitBook es una de las plataformas de documentación más populares entre equipos de desarrollo. Construimos Valoryx para resolver problemas que GitBook no aborda: propiedad del repositorio Git, self-hosting y transparencia en los precios. A continuación, una comparación honesta. Experiencia del Editor GitBook: excelente editor basado en bloques, funciones de colaboración maduras. Valoryx: editor WYSIWYG con Tiptap, más rápido y con salida markdown más limpia. Veredicto: GitBook es más maduro; Valoryx es más rápido y genera markdown más limpio. https://valoryx.org/es/blog/why-git-sync-breaks/ Sun, 22 Feb 2026 00:00:00 +0000 https://valoryx.org/es/blog/why-git-sync-breaks/ Conectas tu repositorio, haces push de un commit desde el IDE y todo se rompe. Conflictos de merge. Ediciones perdidas. Reversiones silenciosas. Esto no es un bug: es un fallo de diseño fundamental. Las Tres Formas en Que Git Sync Falla 1. Espejo Unidireccional. La mayoría de las plataformas tratan Git como una copia de seguridad. Los cambios desde el IDE generan conflictos. El “Git Sync” de GitBook es el ejemplo más visible.