Obtenir de l’aide et contribuer

NoWayOS est développé ouvertement au sein de l’organisation NoWayOS sur GitHub. C’est là que vous trouverez le code, que vous pourrez poser vos questions à son sujet et le modifier.

Questions et bugs

Ouvrez un ticket dans le dépôt concerné : nowayos pour le système d’exploitation, screen-compiler pour la conversion d’écrans, showcase pour les applications d’exemple. Un bon ticket indique ce que vous avez exécuté, ce que vous attendiez et ce qui s’est passé à la place, avec la sortie, ainsi que le commit sur lequel vous l’avez exécuté.

Avant cela, le DEVELOPING.md de chaque dépôt couvre la compilation, les tests et l’organisation du code, et le glossaire explique les termes.

Vulnérabilités de sécurité

Merci de ne pas ouvrir de ticket public pour une vulnérabilité. Signalez-la en privé, via le signalement privé de vulnérabilités de GitHub, dans l’onglet Security du dépôt, ou par e-mail à security@nowayos.com, comme le décrit le SECURITY.md de chaque dépôt. Le signalement reste privé jusqu’à ce qu’un correctif soit disponible.

Proposer une modification

Chaque modification est jugée par les mêmes points de contrôle, consignés dans Defence Agent : ce que vérifie chacun, la menace à laquelle il répond, et qui a le droit de le modifier. Le CONTRIBUTING.md de chaque dépôt donne le détail.

1. Partez d’un ticket accepté par un mainteneur : ouvrez-en un, ou indiquez sur un ticket existant que vous aimeriez vous en charger.
2. Lisez le DEVELOPING.md du dépôt, et en particulier ses règles de base : les points de contrôle les font respecter, donc une modification qui en enfreint une ne passera pas.
3. Faites la modification, avec des tests. Pour un bug, écrivez d’abord le test qui échoue.
4. Lancez make ci et vérifiez qu’il passe.
5. Signez chaque commit (git commit -s) : la ligne Signed-off-by atteste du Developer Certificate of Origin, et un commit qui n’en a pas ne passe pas.
6. Ouvrez une pull request avec le modèle du dépôt : ce qu’elle change et pourquoi, les sources pour un pilote, et toute aide reçue d’un assistant IA. Si elle élargit ce qu’un système accorde, dites-le : un droit élargi est examiné comme une modification de sécurité.

Les mots

NoWayOS emploie quelques mots dans un sens précis : domaine de protection, droit, fichier expect, état de repli sûr, entre autres. Le glossaire définit chacun d’eux.