3 ms·
I'm underwhelmed by the Rust docs. The tutorial is OK-ish, but the reference docs are weak. If I have a specific question about some detail of the language, th
by mjw1007 8y ago
I'm underwhelmed by the Rust docs.
The tutorial is OK-ish, but the reference docs are weak. If I have a specific question about some detail of the language, the answer is very rarely there.
Sometimes the answer is written up in the bug-tracking system or an RFC. They don't seem to have a culture where someone making a behaviour change, or a language-definition decision, is expected to update the reference manual at the same time.
- steveklabnik 8y agoPlease file bugs against the reference when you have these kinds of questions, it really helps. > they don’t seem to have a culture We actually do have that as a literal rule [1], but since we’ve started from a place where the reference is incomplete, we can’t block everything on fully filling out every last detail. It’s being actively worked on though! 1: the rule has been slightly relaxed in the last few months for reasons; now a bug must be filed, rather than writing out the literal text. They usually get done fairy shortly after though.