Carol & Chris chat about The Rust Book (3rd edition)

Added: 2026-05-14

[00:00:00]What's your favorite crate name?

[00:00:01]carol: buttplug.

[00:00:02]amos: buttplug is your favorite crate name? carol, insistent: butt. plug.

[00:00:09]amos: I've had the immense privilege of sitting down with Carol and Chris, the co-authors of the Rust programming language 3rd edition, which now has async await.

[00:00:18]And we have talked about everything from writing the book to editing the book to deciding what should and shouldn't be in the book to conflict resolution between co-authors.

[00:00:26]And most importantly, what they would do if they had to do the book over from scratch again.

[00:00:32]I would not.

[00:00:33]I simply would not.

[00:00:35]Never mind that one.

[00:00:35]I think all we have to do is say, "Hi Vivian," and learn how the book is made.

[00:00:40]The history of the Rust book is complicated and long.

[00:00:44]It dates back to when Steve started writing Rust for Rubyists back in like 2014.

[00:00:49]The main piece of work this time around was go triage all of the open issues on the project and then go write this chapter on async await.

[00:00:58]Async await showed up in the ecosystems as a stable feature of the language in 2019.

[00:01:05]And we were working on this in 2024.

[00:01:07]So we'd had five years of the book existing with zero coverage of async await in it.

[00:01:12]And weirdly, because of the corners and turns my career had taken, I stopped teaching Rust stuff through the podcast three months before async await stabilized.

[00:01:22]And I hadn't had time to go back and pick it up.

[00:01:24]So I taught myself async Rust and then fed what I learned in the experience of doing that into how do we cover this in the book.

[00:01:31]And that ended up actually working out really well, I think.

[00:01:33]I mean, obviously I had Carol giving input, but we also found a bunch of folks in the community willing to come give reviews.

[00:01:38]James Munns, Jon Gjengset Sophia Turner Hugely helpful.

[00:01:42]Tim McNamara did a pass.

[00:01:43]We did a really big reorg after Sophia took a pass.

[00:01:48]But it's still like a 20,000 word chapter, which is actually just a short book.

[00:01:52]And there is a whole separate async book that nrc is the main contributor of.

[00:01:58]But yeah, I was super grateful for Chris to have the availability he did to come in and help.

[00:02:03]And then I got it back into the normal full-time job world and suddenly had no more time anymore.

[00:02:08]And Carol was able to pick it up and carry it through the next phase.

[00:02:14]The next part is like sending it to No Starch, our publishers.

[00:02:18]We have a cobbled together spaghetti of weird scripts and Rust programs and a little bit of XSL in there because we did our first draft in Markdown.

[00:02:30]We do a couple rounds of editing in that.

[00:02:32]At some point No Starch moves it to a Word doc, which is essentially an XML document.

[00:02:37]So I want it back into Markdown to be able to do the diff and get the changes back into the online version.

[00:02:44]So you have bidirectional sync?

[00:02:45]Oh, that's terrible.

[00:02:46]It's the worst.

[00:02:47]Oh, it's so terrible.

[00:02:50]And then there's like the built version of the book because we have a lot of error messages that we show in the book.

[00:02:56]So when the error messages change, we need to update those.

[00:02:58]So I have a script that will go through, compile all the examples, save the output, build the book with the new output, compare it to the old book's output so I can see like when the error messages change and see if we need to update the text around the error Then after the Word version eventually gets into PDF like InDesign, Chris and I are not allowed to touch it at that point.

[00:03:16]We have to leave comments and their designers have to move things around.

[00:03:21]And then like I don't have a way to backport things from there, but usually it's kind of visual changes that we don't really need.

[00:03:28]So it's not as much of an agile style.

[00:03:34]Publishing in general is not.

[00:03:36]Which does kind of clash with like the open source-ness of the book because people are like, oh, this sentence was a little bit confusing.

[00:03:44]It would be better if this, I'm like, do you know how many rounds of edits I have to do if I merge this?

[00:03:51]This is not that big a deal.

[00:03:56]I think it was great.

[00:03:57]I like that they don't shy away from whimsy.

[00:04:00]That's in the whole branding right there.

[00:04:02]If you're on the website, you're doing all the little drawings.

[00:04:04]And the text of the book, for better or for worse, is licensed to MIT and they are fine with that.

[00:04:09]So we're able to offer the free web version, which is also great.

[00:04:13]The editors that we've worked with have been super helpful and have greatly improved the book and it looks very pretty.

[00:04:20]I love their typefaces and the way their books are laid out.

[00:04:25]So yeah, I'm really glad they're involved.

[00:04:27]Very little to say other than that, they're pros and they're great.

[00:04:30]And I really enjoyed working with them.

[00:04:32]And I don't know if I'll ever do a programming book again because it's really hard.

[00:04:36]But if I did, I would be very happy working with No Starch.

[00:04:43]I would be interested to know who has read the book cover to cover because it's a lot.

[00:04:47]Whenever anyone is like, why don't you cover this in the book?

[00:04:50]We cannot fit anything, any more big topics in this book.

[00:04:54]There needs to be more books.

[00:04:56]If you're listening this and you're, well, I don't know if I want to tell people to read it because it's kind of terrible, but it doesn't have to be a whole book.

[00:05:03]It can be a blog post or a YouTube video.

[00:05:06]Write up what you learned from your perspective because we need lots of different points of view to help everyone get in.

[00:05:15]And the book can't possibly be all of them.

[00:05:18]We need more.

[00:05:19]I mean, my background was weird.

[00:05:20]I wrote a weird mix of Fortran and C and C++ and PHP.

[00:05:25]That made my experience of learning very different from someone who came in through purely the Ruby on Rails world or came in through purely a JS bootcamp.

[00:05:34]So what is the difference and what do I do to bridge that?

[00:05:37]Those are the kinds of questions I start trying to ask when I hit those.

[00:05:40]Yeah.

[00:05:40]The worst is when you're using the same words and not until way later you realize that you have different meanings for those words.

[00:05:48]Yeah.

[00:05:48]And we actually made a point with async await to call that out that these are words that you're going to use and the concepts are similar to what you'll be familiar with, but there are some really important differences and we try to flag them up.

[00:06:00]Like the fact that futures are lazy.

[00:06:02]That is not JavaScript's approach.

[00:06:04]And that makes a really big difference in your mental model for it.

[00:06:11]Will Crichton is a professor at Brown.

[00:06:15]He's done some research.

[00:06:16]He has actually an alternative version of the online book with some exercises built-in.

[00:06:21]His theory is that you could actually push learning about ownership way later and that people drop out when they learn about ownership.

[00:06:29]But our our early intuition was, OK, ownership is the most different thing about Rust.

[00:06:35]So we should hit you with that early.

[00:06:36]You're always going to run into these ownership errors and you're going to need to know about it.

[00:06:41]I would love to hear your opinion.

[00:06:42]I think you got it right.

[00:06:44]I think you're right.

[00:06:44]I think it's the most different thing.

[00:06:45]When I hit that chapter, I was like, I'm going to keep hitting that wall until it breaks.

[00:06:51]And it took a couple of tries, but it did.

[00:06:53]And now I know the real model.

[00:06:55]And I think it's kind of bait and switch to just say, yeah, you can Arc::clone all the things.

[00:06:59]Don't worry about it.

[00:07:00]And then later on, OK, this whole static analysis thing that like literally no other language is doing.

[00:07:05]I'm kind of on the other side of the argument here.

[00:07:07]Like if you are being asked to use Rust at your job and you don't actually want to and you're trying to just do your job, like maybe pushing off ownership would be would help you get started faster.

[00:07:20]I don't even want to hit the chapter for ownership and dropped out.

[00:07:24]Go read the brown version if if you feel like you're getting stuck with ownership and maybe put it off till later.

[00:07:33]You could argue that there's like two different levels of Rust that you can write.

[00:07:36]And one is borrow as much as you can.

[00:07:37]Don't clone.

[00:07:38]And then a higher level, which is what you find if you're trying to write a web server on top of Axum and everything is boxed and everything is like, don't have to worry about lifetimes so much.

[00:07:46]And so you can have like the senior Rust expert engineers work on the on the lower level.

[00:07:51]But the thing is that the people working on the upper level of Rust are not really happy because it kind of sucks to have to wrap everything in Arc and Mutex and you get concurrency bugs because of that.

[00:08:02]It definitely depends on your context a lot.

[00:08:05]And there have been people who have thought about making a variant of Rust that like everything is just Arc by default and you don't have to clone everything.

[00:08:14]I don't know if any of those have progressed to a usable state yet.

[00:08:17]I think we would know.

[00:08:18]I think they're mostly fair.

[00:08:19]I think between the three of us, we would know.

[00:08:20]Yeah, this is not, but I mean, Swift also has really good prior art in that Swift does use basically compile time reference counting as the default mode.

[00:08:31]And the performance is not quite where Rust is, but it's very good for a lot of things.

[00:08:36]I love Rust, but what I'm actually almost more excited for in some sense is, okay, 20 years down the line, what do we get that learns the lessons from these things and says, how do we make all the things that we learned from making borrowing easier and ownership easier and all the things that Swift and experimental languages like Val and Hylo and stuff like that are doing with value semantics?

[00:08:59]Like that's going to be really interesting because this area is really hard.

[00:09:03]I'm also excited to see what comes after Rust.

[00:09:05]I don't think Rust is the best programming language ever.

[00:09:10]I think it's a big step forward.

[00:09:14]It is a major achievement.

[00:09:16]I feel like I now command some respect as being the author of the Rust programming language.

[00:09:22]And sometimes I kind of stop and think about the good comments we get.

[00:09:26]They really enjoy the tone.

[00:09:27]And so I feel like I have impacted the world by doing this, which that is what I want out of my career.

[00:09:34]And so I run my own consulting company, integer 32 with my husband.

[00:09:38]I think we have gotten some leads that have said Carol wrote the book.

[00:09:42]So yeah, I think overall it was a good career move for me.

[00:09:45]I also think I was super lucky.

[00:09:47]Rust took off.

[00:09:48]I happen to be in the right place at the right time to help out with the book.

[00:09:51]And I know a lot of other tech books don't do as well.

[00:09:55]For the record, there is absolutely no question that yes, you've had a huge impact on a huge number of people in a very positive way.

[00:10:03]I don't think it's that bad.

[00:10:06]I feel like we are both well aware that there are trade-offs and everything.

[00:10:12]The stuff we produce together is not a reflection on either of us as a person.

[00:10:18]Especially as an author, I think there's a degree to which you have to know that you're too close to it because you're the one who wrote the words.

[00:10:26]When I have three people I really respect come back to me and tell me that it's not working, I should probably listen.

[00:10:31]And also in this case, the thing I was very conscious of is this is not written in my authorial voice.

[00:10:38]You're always doing the work of trying to say, "Look, I'm adding to a thing that already exists and I'm going therefore to try very hard to make this fit with that."

[00:10:48]I came in respecting the work that already existed and respecting Carol as an author.

[00:10:53]It was a pleasure working with you, Chris.

[00:10:54]I'm really glad this ended up.

[00:10:55]Likewise, likewise.

[00:10:56]You can get your own copy of this book for 40% off using code TRPL40.

[00:11:02]That is purple40.

[00:11:03]It's in description if you can't spell.

[00:11:05]That's all from me today and remember, only a bad teacher blames their students.

[00:11:10]Take care.

[00:11:11]I'll see you next time.