The Enarx project follows the Rust coding guidelines.
Any further recommendation we issue should be due to the fact the Rust project has no official guideline on a specific aspect.
If you find one of our coding recommendations to be in contradiction with the Rust coding guidelines, the latter should prevail.
In any case, we will align to new Rust guidelines when published.
Enarx uses semantic versioning.
Comments should be complete sentences with proper grammar.
They should describe both what the code is doing and why it is doing it.
The Enarx project prefers the use of descriptive variable names that give an idea of what that variable is being used for. We do not enforce specific guidelines beyond this preference. For example, we will frown upon extremely short C-style names (think b
with regards to a boolean variable).
In keeping with our general policy on Rust guidelines outlined above, we expect all code submitted to the repository to conform to the Rust formatting guidelines. All Enarx repositories using Rust enforce this requirement as a gating test for new pull requests.
Fortunately, this is an easy requirement to satisfy using rustfmt
, Rust's official formatting tool. If not already installed, you can add it using rustup component add rustfmt
. You can run it on any crate by running cargo fmt
in a crate's root (the same directory that contains Cargo.toml
).