We license all code under MIT / Apache2.0 licenses. The maintainers reserve the right to refuse contributions and reject issues, even when useful.
We use spaces for indentation and adhere to the vanilla rustfmt
style.
Format your code using rustfmt
:
cargo install cargo-fmt
cargo fmt --all
Well-commented code is readable code. We require all pub
and pub(crate)
items to be annotated with doc-strings. This leads to much better auto-generated documentation pages using rustdoc
and a better experience for library users.
Public modules and crates should begin with doc-strings which explain the purpose of the module and crate and assist the reader in determining where to proceed.
We require that the entire test-suite passes for every merged PR. A PR is the responsibility of the author. In submitting a PR, you are consenting to become responsible for it and continually improve, update, and request reviews for it until merged. Stale PRs are not the responsibility of the maintainers and may be closed.
We ask that all contributors maintain a respectful attitude towards each other.