The docs are great, and the fact that numerous examples with line-by-line explanations are coupled with higher-level prescriptions makes the docs great. Often documentation is too formal, and this formality makes it difficult to follow.
On the other hand, the writing style is way too "cute". It is legitimately distracting to see all these "Hooray!" and "Wait, whaaaat?" and "Not too shabby! I love eliminating mutable state.". It's unhelpful at absolute best.
Otherwise - thank you very much for this. Your docs are undeniably crucial for the adoption of Rust and they're extremely helpful.
Thanks. Yeah, I specifically have a thing open for it being too much in my own voice. Since this was basically ported wholesale off of my blog, it was better there...
And you'll be happy to hear my contract includes examples for _everything_ in the stdlib, so get ready for more of those!
On the other hand, the writing style is way too "cute". It is legitimately distracting to see all these "Hooray!" and "Wait, whaaaat?" and "Not too shabby! I love eliminating mutable state.". It's unhelpful at absolute best.
Otherwise - thank you very much for this. Your docs are undeniably crucial for the adoption of Rust and they're extremely helpful.