I would love a documentation "Rust for Pythonist" or "Rust for C++'iste".
I don't like the Wiki page. I think the official documentation homepage should be a nice, beautiful http://doc.rust-lang.org/<http://static.rust-lang.org/>. Period. It should link all "official" documentation in a logical way. Maybe it should provide a link to the wiki page with only "incubating" documentation. I think it should be derived from rst/markdown files in conf, closely linked to the current version of rust lang. Maybe divided in several modules (the summary for rust 0.8 derives from files in the rust 0.8 branch, for master files are on master, branch...). ----- Gaetan 2013/11/15 Daniel Micay <[email protected]> > On Fri, Nov 15, 2013 at 7:46 AM, spir <[email protected]> wrote: > > I'm exploring the tutorial "Rust for Rubyists" at > > [http://www.rustforrubyists.com/book/book.html], which in fact is not > (only) > > for rubyists, as stated in the introduction. Looks pretty good to me > (just > > my opinion), should definitely be pointed to from the Rust Docs page at > > [https://github.com/mozilla/rust/wiki/Docs], and in good place. As a > > tutorial, it is in my view far better than the "official" one, and is > > up-to-date (Rust 0.8), so maybe even just replace it; with a warning > note. > > > > The "official" tutorial is not a bad doc in itself (I guess) but is > > definitely not a _tutorial_: in fact, it requires quite a knowledge of > Rust, > > its fundamental concepts and jargon. "Rust for Rubyists" certainly has > room > > for improvement, but it _is_ for sure a tutorial. I would definitely > suggest > > to start writing a new official tutorial by using "Rust for Rubyists" as > raw > > material. A first pass may be to make it slightly more general, just > > requiring prior programming experience; Rust definitely is not a language > > for programming novices, anyway. > > > > Denis > > The tutorial is currently quite flawed and has ended up being a list > of language features with overviews and low quality examples. Parts of > it are approaching the right level of information, but it's not > written in the style expected of a tutorial. > > I think it's very important to cover the core language features like > boxes and references at a high level. The unique and least > approachable features need great introductory coverage. I recently > replaced the old sections on owned boxes, vectors and strings, so any > concrete feedback on those would be helpful. > _______________________________________________ > Rust-dev mailing list > [email protected] > https://mail.mozilla.org/listinfo/rust-dev >
_______________________________________________ Rust-dev mailing list [email protected] https://mail.mozilla.org/listinfo/rust-dev
