Book: update the book for async/await

[steveklabnik]

This issue tracks inclusion of information about async/await into the Book. This will happen in the 2018 edition.

Tracking issue: None

[steveklabnik]

This feature is no longer blocking rust 2018, and so neither is the docs for it.

[MCTaylor17]

Hello, I'm newish to Rust. Long time fan but I've been waiting for Async/Await to stabilize before jumping into the code. With the release of 1.36 this coming Nov 7th, async/await will be official.

I'm wondering if you have plans for new material?

[carols10cents]

There's actually an entire async book!

[MCTaylor17]

Oh, wow... That's actually more than I hoped. So much to learn, so little time 😬

[steveklabnik]

To be clear, we do eventually plan on covering it in the book, but are unsure how to go about it just yet. It's gonna be a while. This feature is important, so we do want to do it, it's just not simple.

[MaxDZ8]

The async book is first match on my web searches (I am using duckduckgo, search "rust async"), bumping this as I think there is value in integrating, as well as possibly updating the book with anything relevant. I am in the process of initiating my first toy rust project and I appreciate coherent documentation.

Would it make sense to keep it standalone instead and add to "grow with rust" section of rust-lang.org?

[steveklabnik]

We also believe that it is important for the book to cover async/await. However, we cannot promise this will happen at any particular time.

Would it make sense to keep it standalone instead and add to "grow with rust" section of rust-lang.org?

It is not really clear to me what you're asking about specifically. What is 'it'?