Arrastra, suelta, listo: los archivos llegan a los docs de Archyl
Todos hemos escrito ese doc.
«Ver el diagrama adjunto.» ¿Adjunto dónde? «Mira la especificación.» ¿Qué especificación? «Dejé la captura en Slack.» Hace tres semanas. En un hilo. Desaparecida.
Una documentación que apunta a archivos que viven en otra parte no es documentación. Es un mapa del tesoro con la mitad de las pistas arrancadas.
Hoy, eso se acaba. Los docs de Archyl ya pueden guardar sus propios archivos.
Arrastra. Suelta. Listo.
Abre cualquier página de documentación y… suelta un archivo encima. Pega una captura directamente desde el portapapeles. O pulsa Adjuntar archivo y elige varios.
Las imágenes se incrustan justo donde las sueltas — sin gimnasia de Markdown, sin buscar un alojamiento de imágenes. Todo lo demás (PDF, especificaciones, exportaciones, ese CSV que alguien siempre pide) aterriza en un panel Adjuntos ordenado, arriba de la página, donde los lectores realmente lo ven.
¿Captura del bug? Incrustada. ¿Exportación de arquitectura? Un clic para descargar. ¿El PDF de 80 páginas del proveedor? Ahí mismo, junto a la decisión que justifica.
Cualquier archivo. En serio, cualquiera.
PNG, PDF, documentos de Word, ZIP, registros, configuraciones — si es un archivo, es bienvenido. Sin muros de «tipo no admitido». Sin convertir nada para contentar al subidor. Suéltalo y sigue. (Hay un límite de tamaño razonable para que nadie intente adjuntar un Blu-ray — esa es la única regla.)
Almacenado como te gustaría
Tus archivos no inflan la base de datos — viven en almacenamiento de objetos. En Archyl Cloud, eso es Google Cloud Storage: buckets privados, cifrados en reposo por defecto, nada que configurar. ¿Auto-alojas Archyl? Apúntalo al proveedor compatible con S3 que uses — GCS, Amazon S3, MinIO, Cloudflare R2 — tu infraestructura, tú decides.
En cualquier caso, el bucket permanece privado, y las páginas sirven los archivos mediante enlaces firmados de corta duración: tus docs confidenciales siguen siendo confidenciales y los públicos simplemente funcionan.
En pocas palabras: rápido, privado y aguanta tu doc más grande sin despeinarse.
Por qué importa
Un diagrama C4 muestra cómo está formado el sistema. Un ADR captura el porqué. Pero la prueba — la captura, el benchmark, el contrato firmado, el boceto en una servilleta que lo empezó todo — vivía en todas partes menos junto a las palabras a las que pertenecía.
Ahora toda la historia está en un solo lugar: el contexto, la decisión y las pruebas que los respaldan.
Pruébalo en diez segundos
Abre un doc. Arrastra un archivo encima. Míralo aparecer.
Ese es todo el tutorial.
La documentación de arquitectura acaba de dejar de ser pura palabrería.
— Vincent