> ## Documentation Index > Fetch the complete documentation index at: https://docs.mattone.co/llms.txt > Use this file to discover all available pages before exploring further. # Scrivere in questa guida: cosa ci va e cosa non ci va mai > Questa documentazione è pubblica: chiunque può leggerla, e cancellare dopo non basta. La lista secca di cosa non va mai scritto, dove va invece, e cosa fare se è già successo. ## ⚠️ Questa documentazione è pubblica Non "riservata al team". Non "protetta da password". **Pubblica.** Chiunque su internet — un concorrente, un cliente, un ex collaboratore, qualcuno che cerca su Google il nome di una persona — può aprire queste pagine e leggerle **senza fare login e senza che noi lo sappiamo**. Il repository da cui questo sito è generato è privato, ma non è quello a proteggere il testo: ogni pagina che ci entra viene pubblicata qui. **Tratta quello che scrivi come già online.** Se una cosa è scritta qui, è pubblica. Punto. ## Cancellare dopo NON basta È la parte che sorprende tutti, quindi leggila due volte. Ogni volta che qualcuno salva una modifica, ne resta **per sempre** una copia nello storico. Se domani togli la frase sbagliata e salvi di nuovo, il sito smette di mostrarla — ma la pagina **era già stata pubblicata**, quindi è finita nei motori di ricerca e nelle cache, e la versione vecchia resta comunque nello storico, da dove si tira fuori con un comando. **Cancellare una riga sbagliata con un nuovo salvataggio è come cancellare una frase da un messaggio già inviato: tu non la vedi più, chi l'ha ricevuto sì.** Non è teoria. **È già successo**: su una pagina di questa guida sono finiti dati riservati su persone e su clienti. Per toglierli non è bastato correggere la pagina — è servito un intervento straordinario sul repository, fatto di corsa, per pochi paragrafi scritti in buona fede da chi voleva solo essere preciso. Quali dati fossero, e su chi, **non è scritto qui**: per lo stesso identico motivo per cui esiste questa pagina. Se ti serve saperlo, chiedilo a Francesco. ## Cosa ci va Roba che serve a **eseguire un lavoro**, e che resta vera anche se la legge un estraneo. Come si collega uno strumento, cosa fare quando arriva una segnalazione, in che ordine. Dove si clicca, con quale sequenza, e cosa deve comparire alla fine per dire che ha funzionato. Il problema, la diagnosi, la soluzione — senza dire **su chi** è successo. "Se vedi A, controlla B; se B è vuoto, allora è C." Il ragionamento, non il caso singolo. ### Come si scrive una casistica in forma anonima Non serve inventare una storia diversa: serve togliere l'identità e tenere il meccanismo. | Invece di scrivere | Scrivi | | - | - | | «Sul cliente Immobiliare Bianchi il sync non partiva» | «Su un cliente con due appartamenti sullo stesso account il sync non partiva» | | «Mario Rossi ha sbagliato a inserire il token» | «Il token era stato inserito con uno spazio in fondo» | | «Il cliente Alfa paga €X al mese, quindi ha priorità» | «I clienti del piano superiore hanno priorità» | La regola sta in una riga: **il problema è utile, il nome non lo è.** Chi legge deve riconoscere la situazione, non la persona. ## Cosa NON ci va MAI Lista secca. Se stai per scrivere una di queste cose, **fermati**. * ❌ **Nomi e cognomi** di persone interne o di clienti * ❌ **Compensi, tariffe, stipendi, margini, sconti, prezzi interni** * ❌ **Nomi di aziende clienti** — anche solo citate di sfuggita * ❌ **Host di database, indirizzi IP, URL interni** che non siano già pubblici * ❌ **Nomi di variabili d'ambiente** — le sigle tutte maiuscole con il trattino basso * ❌ **Token, chiavi, password** — anche "di prova", anche scadute, anche finte * ❌ **Screenshot con dati dentro** * ❌ **Frasi che dicono dove manca un controllo** — «qui non validiamo niente», «questo controllo non c'è ancora», «chiunque abbia il link entra» Sulle ultime due vale la pena spendere un minuto in più. L'errore non è quasi mai la parte che volevi mostrare: è **il resto della schermata**. La barra laterale con l'elenco dei clienti. La notifica che compare in alto mentre scattavi. La scheda del browser accanto. Un importo in una colonna che non stavi guardando. Un'immagine non la rilegge nessuno prima di caricarla, e non si può correggere a metà: o la ritagli fino a lasciare **solo** il pulsante di cui stai parlando, oppure descrivi a parole dove si clicca — che tra l'altro invecchia molto meglio. Sembra onestà professionale, e in un documento interno lo è davvero. Qui no: **qui è una mappa**. Stai dicendo a chi ci vuole entrare esattamente a quale porta bussare, e gli stai anche risparmiando il tempo di cercarla. Se un controllo manca, la cosa da fare è **segnalarlo a Francesco**. Non scriverlo su una pagina che legge chiunque. ## E se mi serve davvero scrivere una di quelle cose? Non è vietato scriverle. È vietato scriverle **qui**. 👉 **Vanno nel repository privato `mattone-delivery-private`**: è la base privata del delivery. Dentro c'è **una scheda per ogni studente**, legata alla piattaforma, il **registro delle chiavi** (cos'è ciascuna, dove sta, chi la usa) e il diario degli interventi. Non è pubblicato da nessuna parte e si apre solo con un account autorizzato. Lì dentro puoi mettere nomi di clienti, importi, dettagli di configurazione: tutto ciò che serve davvero al lavoro quotidiano. Se non hai l'accesso, **chiedilo a Francesco**: non ripiegare sullo scrivere qui "per intanto". 🔑 **Su questa guida una chiave non ci va mai, in nessuna forma** — nemmeno finta, nemmeno scaduta, nemmeno il solo nome della variabile. Le chiavi degli studenti stanno nel **Vault della piattaforma**, si inseriscono da **Operatività → Connessioni** e le usi dal tuo **MCP Delivery**, senza vederle: quelle non stanno in nessun repository, nemmeno in quello privato. Per qualunque altra chiave, **dove va lo decide Francesco**: chiediglielo prima di salvarla da qualche parte. | | Questa guida (il contenuto è pubblicato) | Archivio interno (privato, non pubblicato) | | - | - | - | | **Risponde a** | come si fa una cosa | cosa è successo, su chi, quando | | **Nomi di clienti** | mai | sì, è il suo scopo | | **Importi e compensi** | mai | sì | | **Chi la legge** | chiunque, anche fuori da Mattone | solo chi ha l'accesso | È la stessa distinzione tra i due registri descritta in [Chiusura e diario](/manutenzione/chiusura-e-diario): la guida dice **come si fa**, il diario dice **cosa è successo e su chi**. ## Mi sono accorto di averlo già scritto. Adesso? **NON fare una modifica che cancella e basta.** Peggiora la situazione: il dato resta comunque nello storico, e in più adesso c'è un salvataggio che indica con precisione dove andarlo a cercare. Non modificare il file, non cancellare niente, non pubblicare altro sopra. Messaggio diretto, non in un canale di gruppo, e non "quando capita". Digli **quale pagina** e **cosa c'era scritto**. Va riscritto lo storico, ed è un'operazione che si fa una volta sola e bene. La fa lui. Nessuno si arrabbia perché lo segnali. Ci si arrabbia se lo si scopre dopo tre mesi, da fuori. **Segnalare subito è la cosa giusta anche quando l'errore è tuo.** ## Il test finale, prima di salvare Rileggi quello che hai scritto e chiediti una cosa sola. ### 🔍 «Se questa pagina finisse su LinkedIn domani, con il mio nome sopra, mi darebbe fastidio?» Se la risposta è **sì** — o anche solo **forse** — non salvarla qui. Toglila, o spostala nell'archivio interno. Se la risposta è **no**, vai tranquillo: è esattamente il tipo di contenuto per cui questa guida esiste. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.