Trascina, rilascia, fatto: i file arrivano nei doc di Archyl

L'abbiamo scritto tutti, quel doc.

«Vedi il diagramma allegato.» Allegato dove? «Controlla la specifica.» Quale specifica? «Ho messo lo screenshot su Slack.» Tre settimane fa. In un thread. Sparito.

Una documentazione che rimanda a file che vivono altrove non è documentazione. È una mappa del tesoro a cui manca metà degli indizi.

Da oggi è finita. I doc di Archyl possono finalmente contenere i propri file.

Trascina. Rilascia. Fatto.

Apri una qualsiasi pagina di documentazione e… rilasciaci sopra un file. Incolla uno screenshot direttamente dagli appunti. Oppure clicca Allega file e scegline qualcuno.

Le immagini si incorporano esattamente dove le rilasci — niente ginnastica con il Markdown, niente caccia all'hosting di immagini. Tutto il resto (PDF, specifiche, export, quell'unico CSV che qualcuno chiede sempre) finisce in un ordinato pannello Allegati in cima alla pagina, dove i lettori lo vedono davvero.

Screenshot del bug? Incorporato. Export dell'architettura? Un clic per scaricarlo. Il PDF del fornitore da 80 pagine? Proprio lì, accanto alla decisione che giustifica.

Qualsiasi file. Davvero qualsiasi.

PNG, PDF, documenti Word, ZIP, log, file di config — se è un file, è benvenuto. Niente muri «tipo non supportato». Niente conversioni per accontentare l'uploader. Rilascialo e vai avanti. (C'è un limite di dimensione ragionevole, così nessuno prova ad allegare un Blu-ray — è l'unica regola.)

Archiviato come vorresti

I tuoi file non gonfiano il database — vivono nell'object storage. Su Archyl Cloud è Google Cloud Storage: bucket privati, cifrati a riposo per impostazione predefinita, niente da configurare. Self-hosting di Archyl? Puntalo sul provider compatibile con S3 che preferisci — GCS, Amazon S3, MinIO, Cloudflare R2 — la tua infrastruttura, la tua scelta.

In ogni caso il bucket resta privato, e le pagine servono i file tramite link firmati di breve durata: i doc riservati restano riservati e quelli pubblici funzionano e basta.

In parole povere: veloce, privato e regge il tuo doc più grande senza battere ciglio.

Perché conta

Un diagramma C4 mostra com'è fatto il sistema. Un ADR cattura il perché. Ma la prova — lo screenshot, il benchmark, il contratto firmato, lo schizzo sul tovagliolo da cui è partito tutto — viveva ovunque tranne accanto alle parole a cui apparteneva.

Ora l'intera storia sta in un solo posto: il contesto, la decisione e le prove a sostegno.

Provalo in dieci secondi

Apri un doc. Trascinaci un file. Guardalo apparire.

È tutto il tutorial.

La documentazione di architettura ha appena smesso di essere solo chiacchiere.

— Vincent