Contributing to AcreetionOS

Thank you for your interest in contributing to AcreetionOS! As a community-driven project run by a small team, your contributions are vital to our success.

Core Principles

• Sovereignty: We prioritize repository sovereignty and user control.
• Stability: Our XLibre foundation (X11-based) is a key stability pillar.
• Simplicity: We aim to make Arch Linux accessible without sacrificing its power.
• Integrity: We value technical honesty and transparent development.

How to Contribute

1. Development

We welcome contributions to our core repositories, custom tools (Mingle, Gittracker), and build scripts.

• Coding Standards: We prefer standardized, portable code. For C projects, we often target C89/C90 for maximum compatibility and simplicity.
• Pull Requests: Ensure your PRs are well-documented and follow the existing architectural patterns.

2. Documentation

High-quality documentation is essential for an accessible OS.

• Help us improve our guides for hardware optimization, especially for high-performance setups (e.g., multi-thread CPU scheduling, large RAM buffers).
• Update FAQ entries and troubleshooting guides.

3. Testing

• Test our latest ISO builds on various hardware.
• Report bugs with detailed reproduction steps and system logs.

4. Community & Support

• Join our Discord or Root servers to help other users.
• Help manage our social media presence.

Repository Sovereignty

AcreetionOS maintains its own repositories to ensure that our users always have access to a stable and predictable set of packages. When contributing, keep in mind that our goals may differ from upstream Arch Linux to maintain this stability.

Attribution

Contributors will be recognized in our project documentation and repository history.