I’ve also triaged the list of “out-of-band” evaluations for crates that are ready to be evaluated. They are updated in the op and also listed here along with their maintainers.
- cfg-if - acrichto
- csv - BurntSushi
- mime - seanmonstar
- regex - burntsushi
- same-file - BurntSushi
- semver - steveklabnik
- tar - acrichto
- threadpool - frewsxcv
- unicode-segmentation - mbrubeck, Manishearth, SimonSapin, co-maintained
These are important crates that for whatever reason the libs team is unlikely to dedicate one of their meetings to. But they still deserve the same polish and review that we pride ourselves on.
This list is composed of crates who’s authors have already assented to having their crates scrutinized as part of the libz blitz. I am additionally contacting the authors of a few others crates.
Volunteers are needed to lead these evaluations. If you are interested say so on this thread.
The process for leading an evaluation is roughly:
- Add the crate to the OP of this thread, either to 'crate schedule’ if it’s going to a libs team meeting, or to ‘other crate evaluations’, for ‘out-of-band’ crate evalautions (like these).
- Open an internals thread using the evaluation template, following the example of previous evaluations. Convert the op to a wiki with the wrench icon in the bottom right set of options.
- Open an issue against rust-cookbook to brainstorm examples.
- Copy the API guidelines checklist to an etherad, linked from the evaluation op.
- Encourage contributors to fill out sections of the guidelines checklist, to make free-form observations on thread, and suggest cookbook examples.
- As guidelines are completed, make notes in the op about potential issues to file against the crate once the evaluation is complete, and matters that need more discussion.
- Work with the crate author to note pre-existing issues that block a 1.0 release.
- After a few weeks, organize the issues and discussion points. Work with the author and community to agree on a set of resolutions and file them as issues on the crate repository, linked to a single tracking issue. Follow existing examples.
- Periodically follow up on the cookbook and crate tracking issues to help drive them to completion.
Hm, this might sound like a big task, and it kinda is, but it’s important work, and so far has resulted in valuable improvements and contributions.