# Contributing
Bomalloc is an experimental allocator, so correctness evidence and reproducible
measurements are required for changes to allocation or reclamation paths.
## Development requirements
- Stable Rust 1.86 or newer.
- x86-64 Windows or Linux.
- A C/C++ compiler for C ABI and external benchmark checks.
Before submitting a change, run:
```text
cargo fmt --all -- --check
cargo test
cargo clippy --all-targets --all-features -- -D warnings
cargo doc --no-deps --all-features
```
Changes to atomic protocols should add or update a Loom model. Changes intended
to improve performance should report alternating fresh-process A/B samples and
use both Windows and Linux regression gates where the path is shared.
Unsafe code must document its caller contract, aliasing assumptions, lifetime
or epoch protection, and the operation's linearization point when applicable.
Do not mix allocations from different allocators or benchmark adapters.
By contributing, you agree that your contribution may be licensed under either
Apache-2.0 or MIT, at the recipient's option.