Rust, gently
A field guide to Rust
The book

The Rust Book,
for orchestrators.

Twenty chapters. Every concept of the classic Rust Book, retold for the builder whose agents write most of the code. Real snippets from the Sail query engine ground every chapter.

Start at Chapter 1 →Jump to OwnershipJump to Errors

Contents

20 chapters · ~4 hours of reading
  1. 01
    Getting started
    Why Rust matters now, and how to set up.
    8 min
  2. 02
    The guessing game
    Writing a real program in twenty minutes.
    10 min
  3. 03
    Common concepts
    Variables, types, functions, flow.
    14 min
  4. 04
    Ownership
    The feature Rust is famous for.
    18 min
  5. 05
    Structs
    Naming the parts of a thing.
    12 min
  6. 06
    Enums and matching
    Closed sets and exhaustive dispatch.
    12 min
  7. 07
    Packages, crates, modules
    How a Rust project is organized.
    10 min
  8. 08
    Common collections
    Vec, String, HashMap, and friends.
    12 min
  9. 09
    Error handling
    The part that catches half the bugs.
    14 min
  10. 10
    Generics, traits, lifetimes
    The three things that scale Rust.
    18 min
  11. 11
    Testing
    Built-in tools, no framework wars.
    12 min
  12. 12
    I/O project
    Build a real CLI, end to end.
    16 min
  13. 13
    Iterators and closures
    Functional features that earn their keep.
    12 min
  14. 14
    More about Cargo
    Profiles, workspaces, publishing.
    10 min
  15. 15
    Smart pointers
    Box, Rc, Arc, RefCell, Mutex.
    14 min
  16. 16
    Fearless concurrency
    Threads, channels, Send and Sync.
    14 min
  17. 17
    OOP features
    What Rust gives you, and what it does not.
    10 min
  18. 18
    Patterns and matching
    Destructure everything.
    12 min
  19. 19
    Advanced features
    Unsafe, macros, advanced traits.
    16 min
  20. 20
    Final project
    A multithreaded web server, by hand.
    18 min
◇ Why this book exists

The Rust Book is excellent. It assumes you will write most of your Rust by hand. Many builders today do not. This edition keeps every concept and reframes each one around the orchestrator's job: reading, gating, and steering agent-written Rust.

⌘ Grounded in real code

Every chapter that fits draws a Sail-aside box with a real snippet from the Sail query engine: a production Rust codebase you can read, fork, and learn from on Apache 2.0 terms.

❯ Pair with the orchestrator playbook

For the operational side, read the Orchestrator track: 12 failure modes, the cargo gates, prompting templates, and a 5-minute PR review playbook. The book teaches the language; the playbook teaches the workflow.