3 ms·

Just a comment: I've noticed Rust literature generally errs on feeling a bit dense and esoteric, which might make things less approachable for some. Then again,

by fny 12y ago

Just a comment: I've noticed Rust literature generally errs on feeling a bit dense and esoteric, which might make things less approachable for some. Then again, that does depend on your target audience. This article doesn't make me feel immediately "fearless" about concurrency, and I'm a fairly experienced programmer and a fan of the language. Perhaps it would have been wiser to start with an approachable example and then taken deep dive about all the nuance from there? Also, are there any plans to integrate tutorial-style guides similar to those from Rust for Rubyists into the Rust book? There's something incredibly fun and real about learning by example. It also would give the reader a chance to read some idiomatic code.

reklawnos 12y ago
Well, Rust by Example already exists: http://rustbyexample.com/ http://rustbyexample.com/ Which has a bunch of examples that utilize most of Rust's features and are runnable/editable in the browser. And there was a comment on /r/rust[1] that made a good point about the documentation: It's better for searching for known-unknowns rather than unknown-unknowns. Since the community is still relatively small and idiomatic Rust is still being defined, it's hard to find those known-unknowns. That being said, I've found that the Rust user forum[2] is very helpful and generally the community is full of people who understand the language way better than I do and who are willing to help. [1]: https://www.reddit.com/r/rust/comments/2zu3eo/what_is_rust_bad_at/cpmobc9 https://www.reddit.com/r/rust/comments/2zu3eo/what_is_rust_b... [2]: http://users.rust-lang.org/ http://users.rust-lang.org/
deleted 12y ago
[deleted]
steveklabnik 12y ago
> Also, are there any plans to integrate tutorial-style guides similar to those from Rust for Rubyists into the Rust book? I'd been waiting for beta to drop to do a re-organization of the TOC of the book. You can see it on nightly here: http://doc.rust-lang.org/nightly/book/ http://doc.rust-lang.org/nightly/book/ I've carved out a whole section, "Effective Rust", specifically for this kind of thing. I'm looking for a better name than "Effective Rust", since that's a very common book title, though. Don't want to be too greedy with that namespace! We do also have Rust by Example, but I admittedly don't give it as much love. Once the book is done...
- fny 12y ago
  Never new Rust by Example existed until today actually! You really should link to it somewhere more prominent. I'm fairly far along, but would have loved the example book had I know about it sooner.
  - steveklabnik 12y ago
    It was originally a community project, but was then abandoned for a while, and then donated to Rust proper. As such, it's always been sort of secondary. I plan on linking it more prominently once I've actually gone through it and cleaned it up to my own personal standards, for now I just keep CI green. As such, the text has gotten out of sync with the code in a number of places, and I don't want to mislead anyone. We do link it from http://doc.rust-lang.org/ http://doc.rust-lang.org/ , but I guess that still says community...
    - fny 12y ago
      Fair enough: it's definitely not a good idea to promote something half baked. It actually took me a while to find the link there just now. I don't think "External Documentation" really imparts the right meaning. Perhaps something like "Other Guides and Resources" would make more sense?
      - steveklabnik 12y ago
        Yeah, that was written when it wasn't an official project, it should move to a different section now.
  - lambda 12y ago
    It is actually linked to from the front page of http://www.rust-lang.org/; http://www.rust-lang.org/; it's the "more examples" link under the example. But I guess that's just far enough down to be easy to miss; it's just below the fold on my screen.
    - fny 12y ago

by fny 12y ago

reklawnos 12y ago

Well, Rust by Example already exists: http://rustbyexample.com/ http://rustbyexample.com/ Which has a bunch of examples that utilize most of Rust's features and are runnable/editable in the browser. And there was a comment on /r/rust[1] that made a good point about the documentation: It's better for searching for known-unknowns rather than unknown-unknowns. Since the community is still relatively small and idiomatic Rust is still being defined, it's hard to find those known-unknowns. That being said, I've found that the Rust user forum[2] is very helpful and generally the community is full of people who understand the language way better than I do and who are willing to help. [1]: https://www.reddit.com/r/rust/comments/2zu3eo/what_is_rust_bad_at/cpmobc9 https://www.reddit.com/r/rust/comments/2zu3eo/what_is_rust_b... [2]: http://users.rust-lang.org/ http://users.rust-lang.org/

deleted 12y ago

[deleted]

steveklabnik 12y ago

> Also, are there any plans to integrate tutorial-style guides similar to those from Rust for Rubyists into the Rust book? I'd been waiting for beta to drop to do a re-organization of the TOC of the book. You can see it on nightly here: http://doc.rust-lang.org/nightly/book/ http://doc.rust-lang.org/nightly/book/ I've carved out a whole section, "Effective Rust", specifically for this kind of thing. I'm looking for a better name than "Effective Rust", since that's a very common book title, though. Don't want to be too greedy with that namespace! We do also have Rust by Example, but I admittedly don't give it as much love. Once the book is done...

fny 12y ago
Never new Rust by Example existed until today actually! You really should link to it somewhere more prominent. I'm fairly far along, but would have loved the example book had I know about it sooner.
- steveklabnik 12y ago
  It was originally a community project, but was then abandoned for a while, and then donated to Rust proper. As such, it's always been sort of secondary. I plan on linking it more prominently once I've actually gone through it and cleaned it up to my own personal standards, for now I just keep CI green. As such, the text has gotten out of sync with the code in a number of places, and I don't want to mislead anyone. We do link it from http://doc.rust-lang.org/ http://doc.rust-lang.org/ , but I guess that still says community...
  - fny 12y ago
    Fair enough: it's definitely not a good idea to promote something half baked. It actually took me a while to find the link there just now. I don't think "External Documentation" really imparts the right meaning. Perhaps something like "Other Guides and Resources" would make more sense?
    - steveklabnik 12y ago
      Yeah, that was written when it wasn't an official project, it should move to a different section now.
- lambda 12y ago
  It is actually linked to from the front page of http://www.rust-lang.org/; http://www.rust-lang.org/; it's the "more examples" link under the example. But I guess that's just far enough down to be easy to miss; it's just below the fold on my screen.
  - fny 12y ago