Our crates do not have a unified order of [package] fields which makes mass edits somewhat inconvinient and makes it a bit harder to compare Cargo.toml files between each other.
The Cargo.toml conventions state the following:
Put the [package] section at the top of the file; put the name and version keys in that order at the top of that section, followed by the remaining keys other than description in order, followed by the description at the end of that section.
So it has a recommendation only for name, version, and description fields. Notably, we (and AFAIK most other developers) do not follow the description field recommendation.
I think it's worth to develop our own convention for the order of all fields.
One potential option is to use the order specified in the cargo book.
Our crates do not have a unified order of
[package]fields which makes mass edits somewhat inconvinient and makes it a bit harder to compare Cargo.toml files between each other.The Cargo.toml conventions state the following:
So it has a recommendation only for
name,version, anddescriptionfields. Notably, we (and AFAIK most other developers) do not follow thedescriptionfield recommendation.I think it's worth to develop our own convention for the order of all fields.
One potential option is to use the order specified in the cargo book.