LordOS — a free, fast and secure GNU/Linux distribution based on Debian, with its own desktop environment: display server and Wayland compositor in C, a React UI engine on QuickJS, and private native apps.
Contributing to LordOS
Thank you for helping. The full guide is at lordos.org/legal/contributing; this is the short version.
Before the repository is public
The repository is private during the early betas. Watch it on GitHub and follow lordos.org to know when it opens. Until then, send feedback through the contact form.
Bugs and ideas
See lordos.org/legal/issues. Use the issue forms; never post passwords or personal data. Security problems are not reported in issues: see SECURITY.md.
Pull requests
- Fork the repository and create a branch from
main. - Keep each pull request to one change, with tests when it changes behaviour.
- Sign off every commit (see below) and open the pull request against
main.
License and sign-off (DCO)
LordOS is released under the MIT license. Contributions are accepted under the same license (inbound = outbound): by contributing, you agree that your work is released under MIT.
We use the Developer Certificate of Origin (DCO): by signing
off a commit you certify that you wrote it, or otherwise have the right to submit it under the
project's license. Every commit must carry a Signed-off-by line with your real name and email,
which git commit -s adds:
Signed-off-by: Your Name <[email protected]>
Pull requests with unsigned commits can't be merged.
Rules
- English only in code, comments, commit messages and documentation. Interface text goes in
assets/locales/{en,es,pt}/, never hard-coded. - Tests must pass:
make -C server test(andmake -C server test-fullwhen you touch the helpers or the sandbox), plusnode tools/i18n-check.mjs, which also runstools/brand-check.mjsandtools/err-check.mjs. - Follow AGENTS.md for the architecture and code rules of each part.
- Brand rules: use the LordOS name, the crown logo and Lumo as described in docs/LORDOS-BRAND.md, and don't use third-party brand or product names in the interface.
- Be kind: everyone here follows the code of conduct.