How to use this site

This site assumes that an AI agent writes the Rust and you review it. You do not need to write Rust from zero. You need to recognize what you see and judge it.

Three questions on every page

Every page answers three questions:

1. What am I looking at? You read the code at a high level. Each concept starts from the Java (or C#) idea that you already know.
2. Is this normal? You learn the idiomatic form, so that you can tell when the code looks like Java written with Rust syntax.
3. Is this a problem? You learn the red flags, how severe they are, and what to tell the agent.

Two reading paths

Path A: learn the model (about 4 hours, in sessions of 10 to 20 minutes). Read this “Start here” section in sequence. Then read the concept pages in the order that the overview gives. The first seven concept pages give you the core mental model: ownership, borrowing, lifetimes, copies, strings, Option, and Result. Finish with the review checklist.

Path B: review now, learn on demand. Open the review checklist next to the code. When an item does not make sense, follow its link to the smell or the concept. Use the symbol decoder when a line looks like punctuation.

Tip

Path B works better after you read Rust in 20 minutes once. It removes most of the “what is this syntax?” friction.

How the pages are built

• Concept pages use the same sections in the same order: one sentence, the Java you know, the Rust you will see, how to read it, what good looks like, red flags, better vs worse, check yourself, and further reading.
• Smell pages have a permanent ID, for example S02. Use the ID in review comments and in instructions to your agent.
• Code on this site is compiled and tested. “Worse” examples compile too, because code that does not compile is not a review problem: the compiler already rejects it.
• Labels: “Worse”, “OK”, and “Better” always have an icon and a word, not only a color.

What this site does not do

It does not teach you to write Rust, and it does not replace The Rust Programming Language. It covers only what helps you review. Where a topic needs more depth, the page links to an official source.