The crate documentation of docs.rs is good for learning the API, but some things like examples and specs are difficult to find for end users, and a mdBook would improve a lot the user experience for these types of things.