Assistenza e contributi

NoWayOS è sviluppato apertamente nell'organizzazione NoWayOS su GitHub. È lì che si trova il codice, che si fanno domande e che lo si modifica.

Domande e bug

Aprire una issue nel repository interessato: nowayos per il sistema operativo, screen-compiler per la conversione delle schermate, showcase per le applicazioni di esempio. Una buona issue dice cosa è stato eseguito, cosa ci si aspettava e cosa è successo invece, con l'output e il commit su cui è stato eseguito.

Prima di farlo, conviene consultare il DEVELOPING.md di ogni repository, che tratta la build, i test e la struttura del codice, e il glossario, che spiega i termini.

Vulnerabilità di sicurezza

Si prega di non aprire una issue pubblica per una vulnerabilità. La si segnala in privato, tramite la segnalazione privata delle vulnerabilità di GitHub nella scheda Security del repository, oppure via email a security@nowayos.com, come descritto nel SECURITY.md di ogni repository. La segnalazione resta privata finché non è disponibile una correzione.

Proporre una modifica

Ogni modifica viene giudicata dagli stessi controlli, messi per iscritto in Defence Agent: cosa verifica ciascuno, la minaccia a cui risponde e chi può modificarlo. Il CONTRIBUTING.md di ogni repository contiene i dettagli.

1. Partire da una issue che un maintainer ha accettato: aprirne una, oppure scrivere su una esistente che la si vorrebbe prendere in carico.
2. Leggere il DEVELOPING.md del repository, e in particolare le sue regole di base: i controlli le fanno rispettare, quindi una modifica che ne viola una non passa.
3. Apportare la modifica, con i test. Per un bug, scrivere prima il test che fallisce.
4. Eseguire make ci e verificare che passi.
5. Apporre il sign-off a ogni commit (git commit -s): la riga Signed-off-by certifica il Developer Certificate of Origin, e un commit che ne è privo non passa.
6. Aprire una pull request con il modello del repository: cosa cambia e perché, le fonti per un driver e l'eventuale aiuto di un assistente IA. Se allarga ciò che un sistema concede, va detto: una concessione più ampia viene revisionata come una modifica di sicurezza.

Le parole

NoWayOS usa alcune parole in un senso preciso: dominio di protezione, concessione, file expect, stato fail-safe e altre. Il glossario le definisce una per una.