Skip to content

Commit 66ba692

Browse files
committed
make the intro less scary
1 parent b52f618 commit 66ba692

File tree

1 file changed

+15
-20
lines changed

1 file changed

+15
-20
lines changed

src/doc/tarpl/README.md

Lines changed: 15 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22

33
# NOTE: This is a draft document, and may contain serious errors
44

5-
So you've played around with Rust a bit. You've written a few simple programs and
6-
you think you grok the basics. Maybe you've even read through
7-
*[The Rust Programming Language][trpl]*. Now you want to get neck-deep in all the
5+
So you've played around with Rust a bit. You've written a few simple programs
6+
and you think you grok the basics. Maybe you've even read through *[The Rust
7+
Programming Language][trpl]* (TRPL). Now you want to get neck-deep in all the
88
nitty-gritty details of the language. You want to know those weird corner-cases.
9-
You want to know what the heck `unsafe` really means, and how to properly use it.
10-
This is the book for you.
9+
You want to know what the heck `unsafe` really means, and how to properly use
10+
it. This is the book for you.
1111

1212
To be clear, this book goes into *serious* detail. We're going to dig into
1313
exception-safety and pointer aliasing. We're going to talk about memory
@@ -19,21 +19,16 @@ and happy career in Rust.
1919
However if you intend to write unsafe code -- or just *really* want to dig into
2020
the guts of the language -- this book contains *invaluable* information.
2121

22-
Unlike *The Rust Programming Language* we *will* be assuming considerable prior
23-
knowledge. In particular, you should be comfortable with:
22+
Unlike TRPL we will be assuming considerable prior knowledge. In particular, you
23+
should be comfortable with basic systems programming and basic Rust. If you
24+
don't feel comfortable with these topics, you should consider [reading
25+
TRPL][trpl], though we will not be assuming that you have. You can skip
26+
straight to this book if you want; just know that we won't be explaining
27+
everything from the ground up.
2428

25-
* Basic Systems Programming:
26-
* Pointers
27-
* [The stack and heap][]
28-
* The memory hierarchy (caches)
29-
* Threads
30-
31-
* [Basic Rust][]
32-
33-
Due to the nature of advanced Rust programming, we will be spending a lot of time
34-
talking about *safety* and *guarantees*. In particular, a significant portion of
35-
the book will be dedicated to correctly writing and understanding Unsafe Rust.
29+
Due to the nature of advanced Rust programming, we will be spending a lot of
30+
time talking about *safety* and *guarantees*. In particular, a significant
31+
portion of the book will be dedicated to correctly writing and understanding
32+
Unsafe Rust.
3633

3734
[trpl]: ../book/
38-
[The stack and heap]: ../book/the-stack-and-the-heap.html
39-
[Basic Rust]: ../book/syntax-and-semantics.html

0 commit comments

Comments
 (0)