Obtener ayuda y contribuir

NoWayOS se desarrolla en abierto en la organización NoWayOS en GitHub. Ahí es donde se encuentra el código, se pregunta sobre él y se cambia.

Preguntas y errores

Abra una incidencia en el repositorio correspondiente: nowayos para el sistema operativo, screen-compiler para la conversión de pantallas, showcase para las aplicaciones de ejemplo. Una buena incidencia dice qué ejecutó, qué esperaba y qué ocurrió en su lugar, con la salida, y el commit sobre el que lo ejecutó.

Antes de abrirla, el DEVELOPING.md de cada repositorio explica la compilación, las pruebas y la estructura del código, y el glosario explica los términos.

Vulnerabilidades de seguridad

No abra una incidencia pública para una vulnerabilidad. Informe de ella en privado, mediante el sistema de notificación privada de vulnerabilidades de GitHub en la pestaña Security del repositorio, o por correo electrónico a security@nowayos.com, como describe el SECURITY.md de cada repositorio. El informe se mantiene privado hasta que haya una corrección.

Proponer un cambio

Cada cambio se juzga con los mismos filtros, puestos por escrito en Defence Agent: qué comprueba cada uno, a qué amenaza responde y quién puede cambiarlo. El CONTRIBUTING.md de cada repositorio tiene los detalles.

1. Parta de una incidencia que un mantenedor haya aceptado: abra una, o diga en una existente que le gustaría encargarse de ella.
2. Lea el DEVELOPING.md del repositorio, y en particular sus reglas básicas: los filtros las hacen cumplir, así que un cambio que incumpla una no pasará.
3. Haga el cambio, con pruebas. Si es un error, escriba primero la prueba que falla.
4. Ejecute make ci y compruebe que se supera.
5. Añada el sign-off a cada commit (git commit -s): la línea Signed-off-by certifica el Developer Certificate of Origin, y un commit sin ella no pasa.
6. Abra un pull request con la plantilla del repositorio: qué cambia y por qué, las fuentes en el caso de un controlador, y cualquier ayuda de un asistente de IA. Si amplía lo que concede un sistema, dígalo: una concesión más amplia se revisa como un cambio de seguridad.

Las palabras

NoWayOS usa algunas palabras en sentidos concretos: dominio de protección, concesión, archivo de salida esperada, estado de fallo seguro y otras. El glosario define cada una.