Governance della documentazione

Il Markdown in docs/portal/ è la sorgente autorevole della prosa e dei runbook pubblicati dal portale. Gli artefatti Brain strutturati restano autorevoli nei rispettivi file JSON; il portale li collega o li sintetizza senza sostituirli.

Quando aggiornare il portale

Aggiornare la documentazione quando cambia un contratto stabile, un confine di autorità, una procedura supportata o il motivo di un controllo. Non usare il portale per conservare priorità correnti, autorizzazioni monouso, stato di deployment o evidenza privata.

Revisione

Ogni modifica segue il normale flusso Issue, branch numerato, Draft PR, validazione repository e merge esplicito di Fra. I diagrammi Mermaid sono revisionati come testo e devono superare la validazione sintattica.

Informazioni vietate

Non inserire credenziali, segreti, dati personali, indirizzi dei destinatari, identificatori privati dei provider o evidenza privata di produzione. Usare solo esempi sanitizzati e informazioni stabili adatte alla pubblicazione.

La procedura pratica è descritta in Contribuire.