4 ms·

Well, I can't speak for tooling or productivity comparison to C/C++, but Rust has one of the best programming language documentations I have ever had the pleasu

by htaunay 10y ago

Well, I can't speak for tooling or productivity comparison to C/C++, but Rust has one of the best programming language documentations I have ever had the pleasure of reading [1]. [1] https://doc.rust-lang.org/stable/book/ https://doc.rust-lang.org/stable/book/

steveklabnik 10y ago
Thank you! Carol and I are working on the second edition, you can read what we have so far here: http://rust-lang.github.io/book/ http://rust-lang.github.io/book/ (I think it's even better, but I'm biased)
- sli 10y ago
  Count me excited. I've always liked the book, but I've also found it fairly lacking in ways I'm not sure I completely understand, I can likely lend part of that to my relative inexperience with Rust and systems programming in general. One I can note is that I really like the new sections. I've never quite liked that the current book is just a bunch of chapters all in a row. Not that that's necessarily bad in and of itself, but I do think the new way is better.
  - steveklabnik 10y ago
    Thanks! If you do check it out, don't hesitate to file issues.
    - copine 10y ago
      How far along is the new documentation? Would it be better to read https://doc.rust-lang.org/book/ https://doc.rust-lang.org/book/ or the github.io page? Maybe both?
      - steveklabnik 10y ago
        Both would be ideal, if you have the time. The new book is far enough along that you can learn the most basic stuff from it, and the intermediate bits are coming along. The more advanced stuff is only an outline. So if you start with new, and then switch to old, you'll get the best of both.
- lobster_johnson 10y ago
  I believe I reported this once, but it's still there: You're hijacking alt-cmd-left/right, which I use for switching tabs in Safari. Your arrow-key event handler needs to have a guard: !(event.ctrlKey || event.shiftKey || event.altKey || event.metaKey) (Thanks for writing great documentation, though.)
  - steveklabnik 10y ago
    Yeah I'm not sure mdbook has patched it yet. I'll make sure a ticket is filed tomorrow, I thought we did, but am not sure. Even if we did, well, that's open source.
- devty 10y ago
  I'm enjoying the new write-up on ownership/references/borrowing! It reads more like an fascinating reading on PL concept than a language-specific manual. Great work!
  - steveklabnik 10y ago
    Thank you!

by htaunay 10y ago

steveklabnik 10y ago

Thank you! Carol and I are working on the second edition, you can read what we have so far here: http://rust-lang.github.io/book/ http://rust-lang.github.io/book/ (I think it's even better, but I'm biased)

sli 10y ago
Count me excited. I've always liked the book, but I've also found it fairly lacking in ways I'm not sure I completely understand, I can likely lend part of that to my relative inexperience with Rust and systems programming in general. One I can note is that I really like the new sections. I've never quite liked that the current book is just a bunch of chapters all in a row. Not that that's necessarily bad in and of itself, but I do think the new way is better.
- steveklabnik 10y ago
  Thanks! If you do check it out, don't hesitate to file issues.
  - copine 10y ago
    How far along is the new documentation? Would it be better to read https://doc.rust-lang.org/book/ https://doc.rust-lang.org/book/ or the github.io page? Maybe both?
    - steveklabnik 10y ago
      Both would be ideal, if you have the time. The new book is far enough along that you can learn the most basic stuff from it, and the intermediate bits are coming along. The more advanced stuff is only an outline. So if you start with new, and then switch to old, you'll get the best of both.
lobster_johnson 10y ago
I believe I reported this once, but it's still there: You're hijacking alt-cmd-left/right, which I use for switching tabs in Safari. Your arrow-key event handler needs to have a guard: !(event.ctrlKey || event.shiftKey || event.altKey || event.metaKey) (Thanks for writing great documentation, though.)
- steveklabnik 10y ago
  Yeah I'm not sure mdbook has patched it yet. I'll make sure a ticket is filed tomorrow, I thought we did, but am not sure. Even if we did, well, that's open source.
devty 10y ago
I'm enjoying the new write-up on ownership/references/borrowing! It reads more like an fascinating reading on PL concept than a language-specific manual. Great work!
- steveklabnik 10y ago
  Thank you!