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. Il merge è l'unico gate umano ordinario e autorizza anche le operazioni post-merge già descritte dall'Issue; Codex non richiede conferme intermedie per quello scope. I diagrammi Mermaid sono revisionati come testo e devono superare la validazione sintattica.

La gerarchia stabile è Fra → scope Issue → review e merge PR → esecuzione autonoma Codex → CI/tooling provider. CI valida soltanto. Le finestre runtime restano esplicite, auditabili, fail-closed e suddivise per effetto. Codex si ferma solo per espansione dello scope, distruzione irreversibile non pianificata senza rollback, autorità o credenziali indisponibili, stato ambiguo non riconciliabile o nuovo rischio Production materiale.

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.