3 ms·
I personally usally find myself searching http://doc.rust-lang.org/std/ http://doc.rust-lang.org/std/. One problem I sometimes run into is that the search seems
by stewbrew 12y ago
I personally usally find myself searching http://doc.rust-lang.org/std/ http://doc.rust-lang.org/std/. One problem I sometimes run into is that the search seems to do fuzzy searches and generates an often overwhelmingly long list of not all too helpful items. E.g. search for "vector" -- a basic building block in rust. The most relevant entry "std::vec" is far down the list. It's also unclear to me, what "experimental" (std::vec) and "stable" (std::vec::Vec) are supposed to mean. Also, during my very first foray into rust, it was not evident to me how the various parts on the page belonged together. Newcomers often are blind to what is evident to the expert.
I also think there should be a consolidated guide, which users can download as PDF and maybe print out (Maybe I'm somewhat old-fashioned in this respect) -- an always up-to-date go-to reference that explains the ins and outs of the language. I don't want to browse 20 guides/tutorials that may or may not contain the info I'm looking for.
- steveklabnik 12y agoYeah, we do a fuzzy search, so it can be weird. To answer your specific question, std::vec is the module, and std::vec::Vec is the actual struct itself... so the module is overall unstable, but the struct itself is stable. If that makes sense. Have you seen "The Guide"? It's about 100 pages long, and we used to produce a PDF, at least...