Como obter ajuda e contribuir

O NoWayOS é desenvolvido às claras, sob a organização NoWayOS no GitHub. É lá que você encontra o código, pergunta sobre ele e o altera.

Perguntas e bugs

Abra uma issue no repositório em questão: nowayos para o sistema operacional, screen-compiler para a conversão de telas, showcase para as aplicações de exemplo. Uma boa issue diz o que você executou, o que esperava e o que aconteceu em vez disso, com a saída e o commit em que você executou.

Antes disso, o DEVELOPING.md de cada repositório cobre o build, os testes e a organização do código, e o glossário explica os termos.

Vulnerabilidades de segurança

Por favor, não abra uma issue pública para uma vulnerabilidade. Relate-a de forma privada, pelo relato privado de vulnerabilidades do GitHub na aba Security do repositório, ou por e-mail para security@nowayos.com, como descreve o SECURITY.md de cada repositório. O relato fica privado até que uma correção esteja disponível.

Como propor uma mudança

Toda mudança é julgada pelos mesmos portões, registrados no Defence Agent: o que cada um verifica, a ameaça a que responde e quem pode alterá-lo. O CONTRIBUTING.md de cada repositório traz os detalhes.

1. Parta de uma issue que um mantenedor tenha aceitado: abra uma, ou diga numa issue existente que gostaria de assumi-la.
2. Leia o DEVELOPING.md do repositório, em especial as suas regras básicas: os portões as impõem, então uma mudança que quebre uma delas não vai passar.
3. Faça a mudança, com testes. Para um bug, escreva primeiro o teste que falha.
4. Rode make ci e veja passar.
5. Faça sign-off de cada commit (git commit -s): a linha Signed-off-by certifica o Developer Certificate of Origin, e um commit sem ela não passa.
6. Abra um pull request com o modelo do repositório: o que ele muda e por quê, as referências consultadas para um driver e qualquer ajuda de um assistente de IA. Se ele ampliar o que um sistema concede, diga isso: uma concessão mais ampla é revisada como uma mudança de segurança.

As palavras

O NoWayOS usa algumas palavras em sentidos específicos: domínio de proteção, concessão, arquivo expect, estado de falha segura e outras. O glossário define cada uma.