Prüfen und beitragen
Hilfe bekommen und beitragen
Wo Sie eine Frage stellen, einen Fehler oder eine Schwachstelle melden, und wie Sie eine Änderung an NoWayOS vorschlagen.
NoWayOS wird offen in der NoWayOS-Organisation auf GitHub entwickelt. Dort finden Sie den Code, stellen Fragen dazu und ändern ihn.
Fragen und Fehler
Eröffnen Sie ein Issue im betreffenden Repository: nowayos für das Betriebssystem, screen-compiler für das Umwandeln von Screens, showcase für die Beispielanwendungen. Ein gutes Issue sagt, was Sie ausgeführt haben, was Sie erwartet haben und was stattdessen passiert ist, mit der Ausgabe und dem Commit, auf dem Sie es ausgeführt haben.
Vorher lohnt ein Blick in die DEVELOPING.md jedes Repositorys: Sie behandelt Bauen, Testen und die Struktur des Codes, und das Glossar erklärt die Begriffe.
Schwachstellen
Bitte eröffnen Sie für eine Schwachstelle kein öffentliches Issue. Melden Sie sie vertraulich, über die private Schwachstellenmeldung von GitHub im Security-Tab des Repositorys oder per E-Mail an security@nowayos.com, wie es die SECURITY.md jedes Repositorys beschreibt. Die Meldung bleibt vertraulich, bis eine Korrektur verfügbar ist.
Eine Änderung vorschlagen
Jede Änderung wird von denselben Gates beurteilt, schriftlich festgehalten in Defence Agent: was jedes prüft, auf welche Bedrohung es antwortet und wer es ändern darf. Die CONTRIBUTING.md jedes Repositorys enthält die Details.
- Beginnen Sie mit einem Issue, das ein Maintainer angenommen hat: Eröffnen Sie eines, oder schreiben Sie in einem bestehenden, dass Sie es übernehmen möchten.
- Lesen Sie die
DEVELOPING.mddes Repositorys, insbesondere seine Grundregeln: Die Gates setzen sie durch, daher besteht eine Änderung, die eine davon bricht, nicht. - Nehmen Sie die Änderung vor, mit Tests. Schreiben Sie bei einem Fehler zuerst den fehlschlagenden Test.
- Führen Sie
make ciaus und sehen Sie zu, wie es besteht. - Versehen Sie jeden Commit mit einem Sign-off (
git commit -s): Die ZeileSigned-off-bybestätigt das Developer Certificate of Origin, und ein Commit ohne sie besteht nicht. - Eröffnen Sie einen Pull-Request mit der Vorlage des Repositorys: was er ändert und warum, die Quellen für einen Treiber und jede Hilfe durch einen KI-Assistenten. Wenn er erweitert, was ein System freigibt, sagen Sie es: Eine erweiterte Freigabe wird als Sicherheitsänderung geprüft.
Die Begriffe
NoWayOS verwendet einige Begriffe in einem bestimmten Sinn: Schutzdomäne, Freigabe, Expect-Datei, Fail-safe-Zustand und andere. Das Glossar definiert jeden davon.