async-book icon indicating copy to clipboard operation
async-book copied to clipboard

Tracking issue: part 1, beginners guide

Open nrc opened this issue 1 year ago • 6 comments

Tracking issue for part 1 of the book. For keeping track of feedback, TODOs, etc.

nrc avatar Oct 10 '24 01:10 nrc

Rename 'advanced async/await' to 'more async/await'

nrc avatar Nov 15 '24 18:11 nrc

Comment on performance motivation: https://bsky.app/profile/graydon-pub.bsky.social/post/3laz2lsae6s22

nrc avatar Nov 15 '24 20:11 nrc

We can tighten up the language around function signatures for async block functions in the adv async/await chapter (see https://github.com/rust-lang/async-book/pull/236#discussion_r1843277047). Probably after 2024 edition released

nrc avatar Nov 18 '24 02:11 nrc

Cancellation, cancellation safety, and structured concurrency

There's been a lot of discussion on how we should cover cancellation and cancellation safety (which intersects with whether and how we should teach structured concurrency). I think these are important topics for the book, and I'd like to work out a proper plan. This also impacts how we should talk about select, etc.

nrc avatar Nov 24 '24 21:11 nrc

More on cancellation - as I'm writing about cancellation on its own and select and structured concurrency, I am seeing a lot of overlap, so note to self to go back and make sure it all makes sense and isn't too repetitive.

nrc avatar Jan 21 '25 03:01 nrc

Note to make sure we introduce fusing futures/streams somewhere and link from the select section.

nrc avatar Jan 21 '25 04:01 nrc