https://valoryx.org/es/ Recent content in Valoryx — Plataforma de Documentación Git-Native on Valoryx Hugo es Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/es/docs/deployment/binary/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/deployment/binary/ Despliegue con binario El método de despliegue más simple — descargue un único binario, ejecútelo en su servidor. Sin dependencias de runtime, sin contenedores, sin orquestador. Descarga Obtenga la última versión para su plataforma: # Recommended (auto-detects platform) curl -fsSL https://valoryx.org/install.sh | sh # Or download a specific platform binary manually curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform # Or download a specific version curl -sLO https://github.com/Valoryx-org/releases/releases/download/v0.5.2/docplatform-linux-amd64 Plataformas disponibles: https://valoryx.org/es/docs/guides/editor/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/editor/ El editor web DocPlatform incluye un editor de texto enriquecido construido sobre Tiptap (basado en ProseMirror) que renderiza Markdown en tiempo real manteniendo plena compatibilidad con el código fuente Markdown. Cada cambio que realice produce un archivo .md limpio — sin formato propietario, sin dependencia del proveedor. Diseño del editor ┌─────────────────────────────────────────────────────────────┐ │ Sidebar │ Editor │ │ │ │ │ 📁 Getting │ ┌──────────────────────────────────┐ │ │ Started │ │ Frontmatter (collapsible) │ │ │ 📁 Guides │ │ Title: ___________________ │ │ │ 📁 API │ │ Description: ______________ │ │ │ > auth. https://valoryx.org/es/cloud/guides/writing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/cloud/guides/writing/ Escritura y edicion Valoryx Cloud le ofrece un editor limpio y sin distracciones que funciona como Google Docs — pero almacena todo en Markdown para maxima portabilidad. Crear una pagina Abra su workspace desde el panel principal Haga clic en + New Page en la barra lateral Escriba un titulo y comience a redactar Las paginas se guardan automaticamente mientras escribe. Cada guardado crea una version en el historial de su workspace, para que siempre pueda volver atras. https://valoryx.org/es/docs/getting-started/quickstart/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/getting-started/quickstart/ Inicio rápido Pase de cero a una plataforma de documentación en funcionamiento en menos de 5 minutos. Esta guía cubre la ruta más rápida; para opciones detalladas, consulte la guía de Instalación. Paso 1: Instalar # Recommended (auto-detects platform) curl -fsSL https://valoryx.org/install.sh | sh O descargue manualmente: curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform O con Docker: docker run -d --name docplatform -p 3000:3000 -v docplatform-data:/data ghcr.io/valoryx-org/docplatform:latest Si usa Docker, vaya directamente al Paso 3: el contenedor se auto-inicializa. https://valoryx.org/es/docs/reference/api/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/reference/api/ Referencia de la API REST DocPlatform expone una API JSON RESTful en /api/v1/. Todos los endpoints requieren autenticación a menos que se indique lo contrario. URL base http://localhost:3000/api/v1 Autenticación La mayoría de los endpoints requieren un token de acceso JWT en el header Authorization: Authorization: Bearer eyJhbGciOiJSUzI1NiIs... Obtenga tokens mediante los endpoints de login o OIDC. Ciclo de vida del token Token Tiempo de vida Propósito Token de acceso 15 minutos Autenticación de API Token de actualización 30 días Obtener nuevos tokens de acceso Endpoints de autenticación Registro POST /api/v1/auth/register Cree una nueva cuenta de usuario. https://valoryx.org/es/docs/configuration/environment/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/configuration/environment/ Variables de entorno DocPlatform lee la configuración de variables de entorno. Establézcalas en su shell, un archivo .env en el directorio de trabajo o su orquestador de contenedores. Servidor Variable Predeterminado Descripción PORT 3000 Puerto de escucha HTTP HOST 0.0.0.0 Dirección de escucha HTTP. Establezca 127.0.0.1 para restringir a localhost. DATA_DIR .docplatform Directorio raíz para todos los datos de DocPlatform (base de datos, copias de seguridad, workspaces, claves) BASE_DOMAIN — Dominio personalizado para documentación publicada (por ejemplo, docs. https://valoryx.org/es/docs/configuration/authentication/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/configuration/authentication/ Autenticación DocPlatform soporta autenticación local (correo electrónico + contraseña) de forma predeterminada, con inicio de sesión OIDC opcional de Google y GitHub para equipos que usan esos proveedores. Autenticación local (predeterminada) La autenticación local funciona sin ninguna configuración. Los usuarios se registran con un correo electrónico y contraseña, e inician sesión con las mismas credenciales. Cómo funciona Registro — El usuario envía correo electrónico + contraseña. La contraseña se hashea con argon2id (algoritmo recomendado por OWASP 2024). https://valoryx.org/es/docs/deployment/docker/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/deployment/docker/ Despliegue con Docker DocPlatform se distribuye como una imagen Docker multi-arquitectura (amd64/arm64) construida sobre Alpine Linux. Inicio rápido docker run -d \ --name docplatform \ -p 3000:3000 \ -v docplatform-data:/data \ ghcr.io/valoryx-org/docplatform:latest Abra http://localhost:3000 y registre su cuenta de administrador. Primera ejecución En el primer arranque, DocPlatform automáticamente: Crea la base de datos SQLite en /data/data.db Genera una clave de firma RS256 en /data/jwt-key.pem Inicializa el índice de búsqueda de texto completo Comienza a escuchar en el puerto 3000 El primer usuario en registrarse se convierte en Super Admin con acceso completo a la plataforma. https://valoryx.org/es/docs/getting-started/installation/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/getting-started/installation/ Instalación DocPlatform se distribuye como un único binario sin dependencias de runtime. Elija el método de instalación que se adapte a su flujo de trabajo. Opción 1: Binario precompilado (recomendado) Descargue la última versión para su plataforma. Linux / macOS # Recommended (auto-detects platform) curl -fsSL https://valoryx.org/install.sh | sh # Or download manually curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform # Verify the installation docplatform version Salida esperada: https://valoryx.org/es/docs/guides/markdown/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/markdown/ Markdown y componentes DocPlatform usa Markdown compatible con CommonMark con frontmatter YAML y 7 componentes personalizados para documentación rica e interactiva. Fundamentos de Markdown DocPlatform soporta la especificación completa de CommonMark más extensiones comunes. Encabezados # Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 Los encabezados generan automáticamente IDs de ancla para enlaces profundos: ## My Section → #my-section. Formato de texto **Bold text** *Italic text* ~~Strikethrough~~ `Inline code` [Link text](https://example. https://valoryx.org/es/cloud/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/cloud/guides/publishing/ Publicar documentos Convierta cualquier workspace en un sitio de documentacion publico y atractivo. Sus lectores obtienen una experiencia rapida, con busqueda y adaptada a moviles — usted obtiene un sitio en vivo que se actualiza cada vez que guarda una pagina. Como publicar Vaya a Workspace Settings → Published Docs Active Enable publishing Sus documentos estaran disponibles al instante en app.valoryx.dev/p/your-workspace-slug/ Eso es todo. Todas las paginas de su workspace ahora son accesibles publicamente. https://valoryx.org/es/docs/reference/cli/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/reference/cli/ Referencia CLI DocPlatform proporciona 5 comandos CLI para gestión del servidor, inicialización de workspaces, diagnósticos y mantenimiento. Opciones globales Estas opciones aplican a todos los comandos: Flag Descripción --help, -h Mostrar ayuda para cualquier comando --version, -v Imprimir información de versión docplatform serve Iniciar el servidor HTTP. docplatform serve [flags] Flags Flag Predeterminado Descripción --port 3000 Puerto de escucha HTTP (anula la variable de entorno PORT) --host 0.0.0.0 Dirección de escucha HTTP (anula la variable de entorno HOST) --data-dir . https://valoryx.org/es/cloud/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/cloud/guides/collaboration/ Colaboracion en equipo Valoryx Cloud esta disenado para equipos. Invite a sus colegas, controle quien puede editar que y vea los cambios en tiempo real. Invitar companeros Vaya a Workspace Settings → Members Ingrese su direccion de correo electronico Elija un rol (vea a continuacion) Haga clic en Send Invitation Recibiran un correo electronico con un enlace para unirse. Si no tienen una cuenta de Valoryx, se les pedira que creen una. https://valoryx.org/es/docs/guides/git-integration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/git-integration/ Integración con Git La sincronización bidireccional de git de DocPlatform permite que su equipo trabaje como prefiera. Los redactores técnicos usan el editor web. Los desarrolladores hacen push desde su IDE. Todos ven el mismo contenido. Cómo funciona ┌─────────────┐ │ Web Editor │ │ (browser) │ └──────┬───────┘ │ save ▼ ┌─────────────┐ ┌──────────────┐ │ Content │ commit │ Local Git │ push ┌──────────────┐ │ Ledger │ ───────► │ Repository │ ───────► │ Remote Repo │ │ │ │ (. https://valoryx.org/es/docs/deployment/production/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/deployment/production/ Lista de verificación de producción Use esta lista de verificación antes de desplegar DocPlatform en un entorno de producción. Cada elemento enlaza a la sección de documentación relevante. Obligatorio Estos elementos son necesarios para un despliegue de producción seguro y confiable. Servidor Almacenamiento persistente configurado — Monte un volumen o use una ruta estable del sistema de archivos para DATA_DIR. La pérdida de este directorio significa la pérdida de todos los datos. https://valoryx.org/es/docs/configuration/permissions/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/configuration/permissions/ Roles y permisos DocPlatform usa control de acceso basado en roles (RBAC) impulsado por custom RBAC, un motor de autorización en proceso. Los permisos se evalúan en menos de 0.1ms por verificación sin servicio externo. Jerarquía de roles DocPlatform define 5 roles públicos en una jerarquía estricta. Los roles superiores heredan todos los permisos de los roles inferiores. Super Admin ← Propietario de la org / creador de la cuenta (rol público más alto) │ Admin ← Gestionar configuración del workspace, miembros, git, tema │ Editor ← Crear y editar páginas (configurable por workspace) │ Commenter ← Ver páginas, dejar comentarios │ Viewer ← Solo ver páginas Platform Owner es un rol interno reservado para operadores auto-alojados para el mantenimiento de la plataforma (migraciones de base de datos, gestión de licencias, configuración del sistema). https://valoryx.org/es/docs/reference/troubleshooting/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/reference/troubleshooting/ Solución de problemas Esta guía cubre problemas comunes y sus soluciones. Para información de diagnóstico, siempre comience con: docplatform doctor Inicio del servidor El servidor no arranca: “address already in use” Causa: Otro proceso está usando el puerto configurado. Solución: # Find what's using port 3000 lsof -i :3000 # macOS/Linux ss -tlnp | grep 3000 # Linux # Option 1: Stop the other process # Option 2: Use a different port docplatform serve --port 8080 El servidor no arranca: “permission denied” Causa: El proceso no tiene acceso de lectura/escritura al directorio de datos. https://valoryx.org/es/docs/getting-started/first-workspace/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/getting-started/first-workspace/ Su primer workspace Un workspace es el contenedor de nivel superior para un proyecto de documentación. Cada workspace se corresponde con un directorio de archivos Markdown y opcionalmente se sincroniza con un repositorio git. Conceptos del workspace Concepto Descripción Workspace Un proyecto de documentación que contiene páginas, miembros y configuraciones Página Un archivo Markdown con frontmatter YAML (título, descripción, etiquetas, acceso) Slug El identificador seguro para URL de su workspace (por ejemplo, my-docs → /p/my-docs/) Miembro Un usuario con un rol en el workspace (desde Viewer hasta Admin) Crear un workspace Mediante CLI docplatform init \ --workspace-name "Engineering Docs" \ --slug eng-docs Mediante la interfaz web Inicie sesión como Super Admin o Admin Abra el selector de workspaces (menú desplegable superior izquierdo) Haga clic en Create Workspace Ingrese un nombre y un slug Opcionalmente configure un repositorio git remoto Conectar un repositorio git La sincronización bidireccional mantiene los archivos de su workspace y un repositorio git remoto en perfecta sincronía. https://valoryx.org/es/docs/configuration/workspace-config/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/configuration/workspace-config/ Configuración del workspace Cada workspace tiene su propio archivo de configuración en .docplatform/workspaces/{workspace-id}/.docplatform/config.yaml. Edite este archivo directamente o use la interfaz web (Settings → Workspace). Referencia completa de configuración # Workspace identity workspace_id: 01KJJ10NTF31Z1QJTG4ZRQZ2Z2 # Auto-generated ULID name: "Engineering Docs" # Display name slug: eng-docs # URL slug for published docs description: "Internal engineering documentation" # Git synchronization git_remote: git@github.com:your-org/eng-docs.git git_branch: main git_auto_commit: true # Auto-commit editor saves to git sync_interval: 300 # Polling interval in seconds (0 = disabled) # Theme theme: mode: auto # light, dark, auto (follows system preference) accent: blue # Accent color for published site # Publishing defaults publishing: default_published: false # New pages published by default? https://valoryx.org/es/docs/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/collaboration/ Equipos y colaboración DocPlatform está diseñado para documentación en equipo. Invite miembros, asigne roles granulares y rastree cada cambio con un registro completo de auditoría. Membresía del workspace Cada usuario pertenece a uno o más workspaces con un rol específico. Los roles determinan qué acciones puede realizar un usuario. Invitar miembros Mediante la interfaz web: Abra Workspace Settings → Members Haga clic en Invite Member Ingrese la dirección de correo electrónico de la persona Seleccione un rol Haga clic en Send Si SMTP está configurado, se envía un correo electrónico de invitación con un enlace único. https://valoryx.org/es/cloud/guides/git-sync/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/cloud/guides/git-sync/ GitHub Sync Valoryx Cloud puede sincronizar su documentacion con un repositorio de GitHub. Esto le da lo mejor de ambos mundos: un editor web atractivo Y toda la potencia de git. Por que conectar GitHub? Respaldo — sus documentos siempre estan seguros en GitHub, incluso si cancela su cuenta Edicion en IDE — los desarrolladores de su equipo pueden editar documentos en VS Code, Vim o cualquier editor Pull requests — use el flujo de trabajo de PR de GitHub para revisar documentos antes de publicar Historial de versiones — git blame, diff y rollback completo para cada cambio Integracion CI/CD — ejecute builds o pruebas cuando los documentos cambien Como funciona Edita en el navegador → autoguardado → auto-commit → push a GitHub ↕ Un companero hace push desde IDE → GitHub → webhook → pull a Valoryx Los cambios fluyen en ambas direcciones automaticamente. https://valoryx.org/es/cloud/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/cloud/guides/mcp/ IA e integracion MCP Valoryx Cloud incluye un servidor MCP (Model Context Protocol) integrado que permite a los asistentes de IA interactuar con su documentacion directamente. Que es MCP? MCP es un protocolo estandar que permite a las herramientas de IA conectarse con servicios externos. Piense en ello como darle a Claude o Cursor una forma de “ver” sus documentos y realizar cambios — con su permiso. Que puede hacer la IA con sus documentos Leer paginas para responder preguntas sobre su documentacion Buscar en todas las paginas para encontrar contenido relevante Crear nuevas paginas segun sus instrucciones Editar paginas existentes (reescribir, mejorar, traducir) Analizar sus documentos en busca de vacios, inconsistencias o contenido desactualizado Configuracion Estado: el endpoint MCP alojado de Valoryx Cloud aun no esta habilitado — las herramientas de IA remotas todavia no pueden conectarse a app. https://valoryx.org/es/docs/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/publishing/ Publicación de documentación DocPlatform puede servir su documentación como un sitio web público — completo con barra lateral de navegación, resaltado de sintaxis y metadatos SEO. No se requiere un generador de sitios estáticos adicional. Cómo funciona la publicación La documentación publicada se sirve en /p/{workspace-slug}/{page-path}: http://localhost:3000/p/my-docs/ → docs/index.md http://localhost:3000/p/my-docs/quickstart → docs/quickstart.md http://localhost:3000/p/my-docs/api/auth → docs/api/auth.md Las páginas se renderizan de Markdown a HTML bajo demanda usando goldmark (compatible con CommonMark) con resaltado de sintaxis Chroma para bloques de código. https://valoryx.org/es/docs/guides/search/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/search/ Búsqueda DocPlatform incluye un motor de búsqueda de texto completo integrado (Bleve) que indexa todo el contenido automáticamente. Sin servicio externo que configurar — la búsqueda funciona de forma inmediata. Uso de la búsqueda Diálogo Cmd+K Presione Cmd+K (macOS) o Ctrl+K (Windows/Linux) en cualquier lugar del editor web para abrir el diálogo de búsqueda. ┌──────────────────────────────────────────┐ │ 🔍 Search documentation... │ ├──────────────────────────────────────────┤ │ │ │ 📄 Getting Started │ │ Install and configure DocPlatform. https://valoryx.org/es/cloud/guides/account/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/cloud/guides/account/ Su cuenta Registro Visite app.valoryx.dev y cree una cuenta con su correo electronico y una contrasena. Debera aceptar los Terminos de servicio y la Politica de privacidad. Tambien puede iniciar sesion con Google o GitHub si esas opciones estan disponibles. Configuracion del perfil Haga clic en su avatar en la esquina superior izquierda, luego en Profile para: Cambiar su nombre para mostrar Actualizar su correo electronico Cambiar su contrasena Configurar una passkey (WebAuthn) para inicio de sesion sin contrasena Facturacion Vaya a Workspace Settings → Billing para: https://valoryx.org/es/docs/guides/ai-features/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/ai-features/ AI Features DocPlatform includes built-in AI capabilities powered by Claude (Anthropic) or OpenAI. These features help you write, improve, and explore your documentation faster. Setup Enable AI features by setting your provider and API key: # .env AI_PROVIDER=anthropic # or "openai" AI_API_KEY=sk-ant-... # your API key AI_MODEL= # optional — uses provider default if empty Restart the server. AI features appear in the editor toolbar and are accessible via the API. https://valoryx.org/es/docs/guides/analytics/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/analytics/ Analytics DocPlatform includes built-in analytics for tracking how your documentation is used. No third-party tracking scripts or external services required. How it works Analytics data is collected in a separate analytics.db SQLite database (not in the main database). This separation ensures analytics never impact content performance. What is tracked Data point Description Page path Which page was viewed Referrer Where the visitor came from Timestamp When the page was viewed Search queries What users searched for What is NOT tracked IP addresses (never stored) User agents are not stored Cookies or cross-session identifiers (without consent) Personally identifiable information GDPR compliance Analytics requires explicit cookie consent from visitors. https://valoryx.org/es/docs/guides/billing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/billing/ Billing & Plans DocPlatform uses Stripe for subscription billing. Three plan tiers are available, each with different limits and features. Plans Feature Community (Free) Free Team ($29/mo) Business ($79/mo) Editors Unlimited 3 15 50 Workspaces Unlimited 1 3 10 Viewers / Commenters Unlimited Unlimited Unlimited Unlimited Pages Unlimited 50 150 500 Published docs Unlimited Unlimited Unlimited Unlimited Analytics — — Included Included Custom domains — — Included Included Advanced AI — — Included Included Priority support — — — Included Annual pricing Annual subscriptions include 2 months free: https://valoryx.org/es/docs/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/docs/guides/mcp/ MCP Server — AI Integration Guide DocPlatform includes a built-in Model Context Protocol (MCP) server that lets AI assistants read, write, search, and manage your documentation directly. Instead of copy-pasting content into chat windows, your AI tools work with your docs natively. Prerequisites DocPlatform running (binary, Docker, or Fly.io) An API key (create one in Workspace Settings → API Keys) Quick start 1. Create an API key In your DocPlatform instance, go to Workspace Settings → API Keys → Create Key. https://valoryx.org/es/changelog/v0.11.1/ Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/es/changelog/v0.11.1/ Esta entrada consolida todo lo publicado entre v0.6.4 y v0.11.1. El detalle completo por versión se incluye en el changelog de la documentación del producto. Servidor MCP: 26 herramientas El servidor MCP integrado creció de 13 a 26 herramientas — CRUD de contenido, búsqueda, paquetes de contexto RAG, análisis de calidad, versionado, exportación, asistencia de escritura con IA, comentarios, actividad, publicación de espacios de trabajo y resolución de conflictos de sincronización git. 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/changelog/v0.5.2/ Sat, 07 Mar 2026 00:00:00 +0000 https://valoryx.org/es/changelog/v0.5.2/ Integración de facturación La facturación con Stripe ahora está integrada. Configura planes, gestiona suscripciones y procesa actualizaciones directamente desde el panel de administración. Integración de webhooks de Stripe con 5 tipos de eventos Gestión del ciclo de vida de suscripciones (crear, actualizar, cancelar) Medición basada en uso para llamadas API y almacenamiento Generación de facturas e historial de pagos Límites de plan configurables por espacio de trabajo Panel de analíticas Monitoriza el rendimiento de tu documentación con el nuevo panel de analíticas. 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. https://valoryx.org/es/vs/gitbook/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/es/vs/gitbook/